From 08ddb5fb294bf785a39aa9d86d9d1f96ec4c94f4 Mon Sep 17 00:00:00 2001
From: bsubbaraman <bms12014@mymail.pomona.edu>
Date: Fri, 8 Nov 2024 16:02:29 -0800
Subject: [PATCH] update doc style

---
 assets/_custom.scss                           |  59 +-
 content/docs/reference.md                     | 230 -----
 content/docs/reference/_index.md              | 124 +++
 .../reference/reference-pages/autohome.md     |  15 +
 content/docs/reference/reference-pages/fab.md |  19 +
 .../docs/reference/reference-pages/move.md    |  27 +
 .../docs/reference/reference-pages/moveE.md   |  21 +
 .../reference/reference-pages/moveExtrude.md  |  33 +
 .../docs/reference/reference-pages/moveTo.md  |  27 +
 .../docs/reference/reference-pages/moveToE.md |  23 +
 .../docs/reference/reference-pages/moveToX.md |  21 +
 .../docs/reference/reference-pages/moveToY.md |  21 +
 .../docs/reference/reference-pages/moveToZ.md |  21 +
 .../docs/reference/reference-pages/moveX.md   |  21 +
 .../docs/reference/reference-pages/moveY.md   |  21 +
 .../docs/reference/reference-pages/moveZ.md   |  22 +
 .../reference-pages/setAbsolutePosition.md    |  17 +
 .../reference-pages/setAbsolutePositionXYZ.md |  15 +
 .../docs/reference/reference-pages/setBedT.md |  23 +
 .../reference/reference-pages/setEAbsolute.md |  15 +
 .../reference/reference-pages/setERelative.md |  15 +
 .../reference/reference-pages/setNozzleT.md   |  23 +
 .../reference/reference-pages/setTemps.md     |  26 +
 .../reference/reference-pages/travelTo.md     |  29 +
 content/docs/resources/guides/cc-intro.md     |   2 +-
 content/docs/resources/guides/dfab-intro.md   |   2 +-
 content/docs/resources/guides/p5fab-primer.md |   2 +-
 .../docs/resources/tutorials/cube-tutorial.md |   2 +-
 .../resources/tutorials/line-vase-tutorial.md |   2 +-
 .../tutorials/non-planar-tutorial.md          |   2 +-
 public/404.html                               |   4 +-
 ...6a14c878c80458c7d3a9738747c123a4aadf56.css |   1 +
 ...cae2dfaa63039376cd11fa6146fcb8f19254b7.css |   1 +
 ...cdf95ea6927737137f4934b3c5210b9f5c1f83.css |   1 +
 ...213e027289287344d4c842ad8288fcae3a33c0.css |   1 +
 ...00ef04367384144e4be93ae795aae7125a8cd4.css |   1 +
 ...ff076605273ff1728c17934411a2a02255c638.css |   1 +
 ...e3d64ad74fea8a4f755d12ad3fc922c31fa1ba.css |   1 +
 ...b33e745e295bb1e88e3582ad1cb410caf63e24.css |   1 +
 ...a6f30705e58bd43123a27d6aa2cad3008f4d03.css |   1 +
 ...8fc650050f3280290baf3890750bd07e82e22d.css |   1 +
 ...49091d16e20ae29f03000b15f96b68e046fb66.css |   1 +
 ...d660497878963a10f908f2f287a4b02d4786d9.css |   1 +
 ...c4511449ae6ae6dad81aa4ae8de6ab4812a730.css |   1 +
 ...fc282bedd08b8a78691f790263abeb68543b58.css |   1 +
 ...f931b7c4c9567742e4dc280f862d6bc256f2ec.css |   1 +
 ...ba614621b1414122d22def9867c8ef97cbd1ee.css |   1 +
 ...c312161f8d2e49604b42b65a0e77ed959666e6.css |   1 +
 ...7d00ce7a9d0cdbdd7f2997a49c050443c97961.css |   1 +
 ...1132b5f99d8e5e7766c8b74649413f9c2bba4a.css |   1 +
 ...57f177f94eba1bb28e5ceb37f7fac177a28364.css |   1 +
 ...5dc4ebc4ee1900da5122d21d790a60f75de8b3.css |   1 +
 ...23b4e83e77c69f85290fca9fc894555f7892c4.css |   1 +
 ...7917a902e6f0b8cc48305d9c0932daee67a05e.css |   1 +
 ...a13883ea8af36fc02d099db5c21afa2edb0af8.css |   1 +
 ...adae4800964136df28327ff0bf24616c0038ca.css |   1 +
 ...fea6b13e89c16ee5853f8a54abe6fe325738b6.css |   1 +
 ...09119fb94fb6c11c1b3210dcc2db68e3a318e6.css |   1 +
 ...d06e333d5bc0012219bb61df4eb33975a242f8.css |   1 +
 ...4dfbb1af36de53744d3a1856962e774d29b005.css |   1 +
 ...2ab6bb0840e57e347335ecb3db9ae6b34f5cf5.css |   1 +
 ...a403b45a7f1b1f1a4257f32dbf305dd22a0453.css |   1 +
 ...d24d049467143106f678c901012be17613c243.css |   1 +
 ...cfc0f394c3dfad0396701122600d6093339ef4.css |   1 +
 ...01bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css |   1 +
 ...c1cc84b8d139f95323f911bc1a08177148ace5.css |   1 +
 ...4431246631d9dfaca74182165a8ab43f88eaf7.css |   1 +
 ...4f9360f936f281cddd7b22470c8d82871b42cf.css |   1 +
 ...bffbfda16067dfe0f135879b6a0dc312c36124.css |   1 +
 ...32ddb6d9c8255c2afd646dceabf79e434bd8d6.css |   1 +
 ...49caddfda8351226bd8f535de671165cc485b1.css |   1 +
 ...8597cb0840071f11dc2224b89dab98c007fdbe.css |   1 +
 ...b9357ec9434e5702c4a923aed5257b2b035b77.css |   1 +
 ...45eac4b9b2e57ffca4692a0bff064b8a96511a.css |   1 +
 ...547a4746cc0a5bc05f817d410053a1f569ce23.css |   1 +
 ...811e85275c09d423c856646bcd54adefcce28b.css |   1 +
 ...00e39435936e3e85a58a2545a515cc1419bc76.css |   1 +
 ...6c73a64c417e37a8e795002394d80704f78ed8.css |   1 +
 ...d46a63ae47fd1987793ffb1cd76311de785de8.css |   1 +
 ...b4901564c67a81f93a20b871d319023d81e9d9.css |   1 +
 ...c22eb97de6e5180a04c5573a741afe0beb4672.css |   1 +
 ...431a4bdfad3f52da0b692e10e211c9ea991408.css |   1 +
 ...45c0ef3b99886dfb028a0be7e29b28b913c6f7.css |   1 +
 ...c02ae912709b5c530451b9ab0f8c55292bbf0f.css |   1 +
 ...c85749ca36be6f2b4635b070ce2be57053aec1.css |   1 +
 ...3a30c9a002e97e28b4cd2d2d9855c7c9088169.css |   1 +
 ...d56cf4f3b70eba27526efb5c6a9d1f2cb825a2.css |   1 +
 ...889fcbdfb7d78b0ae53125682012ff5c666381.css |   1 +
 ...c79eef4b1adc123192b661f57c33c92b977c28.css |   1 +
 ...1951c91e9504cd09c4bb64abccc6e7650cac73.css |   1 +
 ...0b87762480d7ddbb0e2c12b3a561abda21e224.css |   1 +
 ...3162f88fd2bded862432ca9207e7fe2e344341.css |   1 +
 ...11e8caaee64db782fc6509ea85d690eea99b71.css |   1 +
 ...c5595066754edc466600b61e9d236ad2e6ce7b.css |   1 +
 ...09668d1c7aa866d348fa5d8135a7a82baf2f5f.css |   1 +
 ...6c6ce8c0d41ad99b40352bfae88dad8e08444c.css |   1 +
 ...872387d966ce05a7f32222bc72ab74e700f16d.css |   1 +
 ...f23061da7a44cfd27d8160398610c4f6105ff7.css |   1 +
 ...d7bfbe1a96253aeec50fe30888392189d8e978.css |   1 +
 ...eb2747a7213ffa031f01bee26c4ef1b2691362.css |   1 +
 ...987361c62ebc9877946527f372331bcec1c639.css |   1 +
 ...6f6047848472a80489f2e94157bb980517c289.css |   1 +
 ...aad8a43cc8dd29a6447b8a06f63fd7ff0b859d.css |   1 +
 ...f90dc5f45ac8d1f74c2b34f70af6a4e2911cad.css |   1 +
 ...92bd0bc8f5eb40cafb0ef9be4e796399869921.css |   1 +
 ...57dc8dacea8a0ca96f464d2df0f896ecc4a6ea.css |   1 +
 ...cc3a9298e6c7549c4bccbc954d9079e2dc7bdb.css |   1 +
 ...9388de75b2fb08f9985369711762efe01eb232.css |   1 +
 ...5e9e631d0756ff04ae6f600e638bfc4b853335.css |   1 +
 ...daa777181171bba8048e2a2769c9b05348eed1.css |   1 +
 ...02bdcea1dbcea6b15b088bff9a96da40b8bcef.css |   1 +
 ...3828e2d022621bc3a1ea039b9d560f59d0c39b.css |   1 +
 ...27c3b0373e09fbcb1d4dc9c9e393721950b9f3.css |   1 +
 ...2b7bbbf9e31a0ef79c47246dec25e32187f47a.css |   1 +
 ...5485a06b434e976c449542c14e66609bd098eb.css |   1 +
 ...5aac19489e510d092c8a796fb1949e4c5bb4aa.css |   1 +
 ...80632b7a9894df67a6364cd8e49e47be935636.css |   1 +
 ...45226e7c3c500a3ec7366fc01d03e80cbfe80e.css |   1 +
 ...a36ce75a40835f84f4f752adeba935845dc967.css |   1 +
 ...f02226a1b1f278df3eedf92bd3019076a156ed.css |   1 +
 ...9260ac9f2cf9252e2c591081be91cf2d66bdfe.css |   1 +
 ...788ae001afb7e2e7babce01263b2f3d021ff06.css |   1 +
 ...a3387666e734785959f37b7448525a983e3774.css |   1 +
 ...d281fb97478fd32ae8fae3cb78d85dca723788.css |   1 +
 ...3962c32df6cbccc3abab8194fbaa9602e53ed8.css |   1 +
 ...1bb4f3b50031d3708af8624945c5a601395567.css |   1 +
 ...ae2c146f8d7e3f5f456ac8ef61366ac0608b02.css |   1 +
 ...d63c01e97a2f65b011d3d31c79322eded67ae3.css |   1 +
 ...a54affc097e820e189d1fdcf110546267b104e.css |   1 +
 ...33b05563cb53d5eebead6612ad009c9a4a3192.css |   1 +
 ...d81f9cfff00747c98c3c1dae5760bf04fba8cf.css |   1 +
 ...583a6abe45c9bb8cdf8442c643036ee0a2cb49.css |   1 +
 ...6cb2aed7ea3d74314cdca1647f15d7844ba1d8.css |   1 +
 ...0cbe9e2381d8ad83405398926710832ec4cd03.css |   1 +
 ...94bf6163837f7a78f7ac216d84f4aad582c273.css |   1 +
 ...98193fe04941af6a3419d9fbcdfc964278fbb3.css |   1 +
 ...04bbc1c7e333ad0f64c36fde411a29c5fe6997.css |   1 +
 ...257bc9272599fdd6ecfae80245e666a57c7b54.css |   1 +
 public/categories/index.html                  |  72 +-
 public/docs/index.html                        |  83 +-
 public/docs/index.xml                         |   7 -
 public/docs/machine-compatibility/index.html  |  72 +-
 public/docs/quickstart/index.html             |  83 +-
 .../docs/reference-pages/autohome/index.html  | 572 +++++++++++++
 public/docs/reference-pages/fab/index.html    | 583 +++++++++++++
 public/docs/reference-pages/move/index.html   | 577 +++++++++++++
 public/docs/reference-pages/movee/index.html  | 575 +++++++++++++
 .../reference-pages/moveextrude/index.html    | 580 +++++++++++++
 public/docs/reference-pages/moveto/index.html | 577 +++++++++++++
 .../docs/reference-pages/movetoe/index.html   | 575 +++++++++++++
 .../docs/reference-pages/movetox/index.html   | 575 +++++++++++++
 .../docs/reference-pages/movetoy/index.html   | 575 +++++++++++++
 .../docs/reference-pages/movetoz/index.html   | 575 +++++++++++++
 public/docs/reference-pages/movex/index.html  | 586 +++++++++++++
 public/docs/reference-pages/movey/index.html  | 575 +++++++++++++
 public/docs/reference-pages/movez/index.html  | 575 +++++++++++++
 .../docs/reference-pages/setbedt/index.html   | 531 ++++++++++++
 .../reference-pages/setnozzlet/index.html     | 578 +++++++++++++
 .../docs/reference-pages/settemps/index.html  | 579 +++++++++++++
 .../docs/reference-pages/travelto/index.html  | 580 +++++++++++++
 public/docs/reference/index.html              | 785 ++++--------------
 public/docs/reference/index.xml               | 158 ++++
 .../reference-pages/autohome/index.html       | 274 ++++++
 .../reference/reference-pages/fab/index.html  | 300 +++++++
 .../reference/reference-pages/move/index.html | 290 +++++++
 .../reference-pages/movee/index.html          | 287 +++++++
 .../reference-pages/moveextrude/index.html    | 294 +++++++
 .../reference-pages/moveto/index.html         | 290 +++++++
 .../reference-pages/movetoe/index.html        | 288 +++++++
 .../reference-pages/movetox/index.html        | 287 +++++++
 .../reference-pages/movetoy/index.html        | 286 +++++++
 .../reference-pages/movetoz/index.html        | 286 +++++++
 .../reference-pages/movex/index.html          | 286 +++++++
 .../reference-pages/movey/index.html          | 287 +++++++
 .../reference-pages/movez/index.html          | 287 +++++++
 .../setabsoluteposition/index.html            | 285 +++++++
 .../setabsolutepositionxyz/index.html         | 282 +++++++
 .../reference-pages/setbedt/index.html        | 289 +++++++
 .../reference-pages/seteabsolute/index.html   | 282 +++++++
 .../reference-pages/seterelative/index.html   | 282 +++++++
 .../reference-pages/setnozzlet/index.html     | 289 +++++++
 .../reference-pages/settemps/index.html       | 291 +++++++
 .../reference-pages/travelto/index.html       | 294 +++++++
 .../docs/resources/guides/cc-intro/index.html |  72 +-
 .../resources/guides/dfab-intro/index.html    |  72 +-
 .../resources/guides/p5fab-primer/index.html  |  72 +-
 public/docs/resources/index.html              |  72 +-
 public/docs/resources/index.xml               |  30 +-
 .../tutorials/cube-tutorial/index.html        |  72 +-
 .../tutorials/line-vase-tutorial/index.html   |  72 +-
 .../tutorials/non-planar-tutorial/index.html  |  72 +-
 ...4e43073b3529d0b5cfddc90692fa868fc35c2.json |   1 +
 ...4badc7b7913d64a4ed055dea05c5b2d04446e.json |   1 +
 ...7e69bd76e5c051cd3ee6e27416d40471231a4.json |   1 +
 ...3fc0e6a6a21fd9d2158798630e30fccbfa641.json |   1 +
 ...33c574c68fffa371091bc49bb66cd064a724a.json |   1 +
 ...f7fe104d2733eaeaf7b7d05a2333e7025a671.json |   1 +
 ...f8914acf1dbfcd47a07db3991689d11479374.json |   1 +
 ...eb1c837eb8987f710edb230037cde896c3f5f.json |   1 +
 ...155ac0269d10f548c9349f17900f8c7f83371.json |   1 +
 ...74207a27381ebeed46abd8f9d36faca646b33.json |   1 +
 ...99881ec0273271360f28f28435bd07f28fdfb.json |   1 +
 ...8a54f33223e7e0614671cc64d036a8bd5a8f3.json |   1 +
 ...0a5f18b7840891b83f26f6faae6426c099e46.json |   1 +
 ...9ce9f941e9def9bfe3a1c51c48c886690209c.json |   1 +
 ...91a108f8af987ef2aed3b18896ca71eba91c2.json |   1 +
 ...e7cf2096763fe62c07363914d17d8b1ac8e56.json |   1 +
 ...e21eec0b0505476aa0ee7cce39ce71cb8ab16.json |   1 +
 ...cc0150432fc6de5d2a5d242641dad06adb3d2.json |   1 +
 ...03c248a93d226a4caf7343d1b27f009eadaf5.json |   1 +
 ...e2838298caf75461c71e11c85e70c64a9e60e.json |   1 +
 ...23514324f48a3d4503df2789e1ee031fe8d90.json |   1 +
 ...80bb2c84c4292d5bbddc6488b39aebc01fcc7.json |   1 +
 ...a255447e5f3ed79c02231fa561f469d6fb4c0.json |   1 +
 ...9d653f8b533533fac5465d32398e76b03b8b3.json |   1 +
 ...f4797c070e5b270ba38de6ccc3a4818affab8.json |   1 +
 ...e19c1d9e9a0feed8ca5eaea4bfc8a798ab026.json |   1 +
 ...ee2e922f6b9acc960cead3e744a3d329e8035.json |   1 +
 ...c45f22f075676b5aa4026d1babde6cd5b9615.json |   1 +
 ...4f3a9cef1bfa7e7b929136564bec7b8d38e13.json |   1 +
 ...076f4f30b599a70f896650925a0ff96716a34.json |   1 +
 ...24b0d9c2324950165061c798e944d6c336f53.json |   1 +
 ...e0da8a8c5e52a0a535f6150bd2972fb74f744.json |   1 +
 ...ef7fb9d331a4f03d4af45671d21e60b53678c.json |   1 +
 ...95a12084d32e0442d5a1c8f6c398100923946.json |   1 +
 ...5343d45fc205cdcfe5f00647dc98c5d553336.json |   1 +
 ...d610c01aabdf07db05aea4431ae292667aaad.json |   1 +
 ...7dba3ff5f0c40dd4fb0c1c0ee9258275e496d.json |   1 +
 ...e26de3fb58161f9edddfc9c94620923320aa7.json |   1 +
 ...65582ab1f36f9eefc09396ef53bdac0d7317b.json |   1 +
 ...860d2f02ad8c70b75ee5864ded5adc3a67fa9.json |   1 +
 ...cb991bb5ac3970dfe6ecc444bdb7ac39e22d0.json |   1 +
 ...1a29a701136efbc50403977ab87f648665f45.json |   1 +
 ...51655146e4b0cb5e259b0803857931ce18cee.json |   1 +
 ...b843aa5f4347ba038182bf0293ad11fa91ccb.json |   1 +
 ...5387a9c63d0dae18887b9b660fdd40fe6bf90.json |   1 +
 ...656edca91be2fec79d3d2492fb610fcee29c0.json |   1 +
 ...9d219663514e6bd370d1fefb6cc4003665bfb.json |   1 +
 ...cc6369b593e82312eb8deb610820805be14ad.json |   1 +
 ...7a866eb1c69bcd4db0c41f91422935ef10597.json |   1 +
 ...df06e4c5452a789b703f2415781ec9f13e036.json |   1 +
 ...0244fe0660f2c3c34d47689a4817cbc1c5277.json |   1 +
 ...1646444c02394a04d1f3d5cbd08dd169ed98c.json |   1 +
 ...3f1c23dd63f493ee6aec2551998b717186cee.json |   1 +
 ...0976a055f0ed41df653a39a82859938ffde6f.json |   1 +
 ...b0161cab328c29957a53f4f0eded5b20e2dbd.json |   1 +
 ...9daa59bc1f8db14bf27672640d0ba4b0a5637.json |   1 +
 ...3a41e206663e7aeb268e1ffe69f1610e3a6c4.json |   1 +
 ...74f07bec15ba12622a7a3c0ca79b37b4e00fa.json |   1 +
 ...f45e8c1dd525876f5df2f217a332e7b698b01.json |   1 +
 ...14ebd13db1bc4a0ed4a1da8af101c8f211c29.json |   1 +
 ...1faba6cd7df99151431b63318e328cafbffd8.json |   1 +
 ...98df09a4a43689412b4091368c64f1b9ea204.json |   1 +
 ...3dbf5be644a50ef023e6ed6d8403bb0e3af8f.json |   1 +
 ...0b03bd83d734aaa6dabe48149f256251d788b.json |   1 +
 ...b615f4f8d5b8281b6fc1c2a3c7cb4044fbf8a.json |   1 +
 ...730053f4c81847dcb660ad19e42c63c9a444c.json |   1 +
 ...82dd09dc094acf6ded34e0942911f94a080b1.json |   1 +
 ...763134c296638d2450011a7cad46facae1b7e.json |   1 +
 ...52fa01a89ed8be9a761723befcefe87497135.json |   1 +
 ...8840ce657e3d0cd963becc81d1d5448c3c030.json |   1 +
 ...c8304dfb364dca417ba356000e0c617c0eb2a.json |   1 +
 ...e3a815f6627e00d11557be52a99e5b1a44231.json |   1 +
 ...91a7a34c3906249e666635e5e5712bc39b4cd.json |   1 +
 ...07db68559e25265ea9a4daeced86b305b711f.json |   1 +
 ...83251311b144cea0763e2283cf364553113f2.json |   1 +
 ...b0a1e5ae1ce30723a81e6e9cd45328ea1d46c.json |   1 +
 ...2d73640d8cd5c773fc19c26f15900f321438d.json |   1 +
 ...fdde765cd64ce3d49651e2b9b9bc9959b1f61.json |   1 +
 ...fbb932f699ea27e97f71802fb46e2b7fc0b07.json |   1 +
 ...fa830b28f77cf9efd8699e84043162133b030.json |   1 +
 ...413a4eefd34aa3bfa41259825737e2d5b9566.json |   1 +
 ...ed86f95ac0dff3da3ea7a7c40e461bec826e0.json |   1 +
 ...2502ffb38b06e0a460e7a2f082cfedfe90af2.json |   1 +
 ...fe3d65160bfc63090e47f3c1c06ec3746066f.json |   1 +
 ...9282d69a20863acd3c536e7a03dc912bc3b9c.json |   1 +
 ...45bd457430d82fce36d01b81d3b26ad8de96d.json |   1 +
 ...5d604d0802cceec1e58355361d744d59891d6.json |   1 +
 ...8ee801354d45cc5867530a965c6dcda605ebf.json |   1 +
 ...b9a101c29b65506def9dbcb2c9419d4600a95.json |   1 +
 ...f6ad4465953a6469ea180e4ef2c8c8cbd8ae2.json |   1 +
 ...b0da505310b8bc00c5d213273b3e64b8a82c6.json |   1 +
 ...5d3df004cd5467cd751f7325ec7664324a5b8.json |   1 +
 ...f6e4571b96d65a99e8f22c84a185c8b2cb035.json |   1 +
 ...a94ff070e7d5643793d3b6875fb107ff215e3.json |   1 +
 ...d58553187d1fa7d90555abe3b69363269277b.json |   1 +
 ...a33f30d41b11a84c7dfd7479e58999931f39f.json |   1 +
 ...3db31d89992a82f52bbfbd3f79483047786d1.json |   1 +
 ...7e00ff81fd4ab33add9c82975300375f2a593.json |   1 +
 ...dd0e32c62bc43b08e4db4f825ce94b0cfd608.json |   1 +
 ...e1be6badfd87c89aebb5e209c17ae29497a67.json |   1 +
 ...4b6251be839876c1a0db228a0617d6ec5f446.json |   1 +
 ...635ceec6db987683d966ca13e6f16263b49ae.json |   1 +
 ...74c84f29c50bee03187afe1288aab7e21ead7.json |   1 +
 ...8ac819e50499408f143203e44e3d42c1cd049.json |   1 +
 ...55d97a8e04cfc34b38e31dcda5c5bf08baed3.json |   1 +
 ...b523b50b018784c4d43d3b19640c6721f8968.json |   1 +
 ...97b8d9c5bfdcedf2aaaf965c1e57d06953df8.json |   1 +
 ...c3b6433a46cc0a8709d3ace6f55fbf48b6a32.json |   1 +
 ...56d494adea3c6fdee8ceef49f1ae80c8dc306.json |   1 +
 ...52258561894883a4c2b22dae8ddae27595333.json |   1 +
 ...b583611a3fed8658bbd6c80944f3b650b7ff0.json |   1 +
 ...17f340a3281a7cd6c85c873b240b72e030c34.json |   1 +
 ...c82273867662ce5240c50a65a93cba1c6850a.json |   1 +
 ...d6c93f835666d942dc95b2d6f8e9a8f9aff06.json |   1 +
 ...d153816affa6e897b7fef2a8a5bc80e8912d8.json |   1 +
 ...e6263b113e49c35e26912602aa5188313d167.json |   1 +
 ...701734e00b22ccc57302db0f19b0c4da71648.json |   1 +
 ...42a9d66ff059f80905c483f47d8171942ebbc.json |   1 +
 ...7a3eab76e39bc629cbc1fff8798ac022a0978.json |   1 +
 ...6c11d0eff7c3c7421f1d2e863ce7512619ae7.json |   1 +
 ...f3931f00a4e92368f7bb01944ab605d59f29a.json |   1 +
 ...0eaddbb9451c7daeb9c5e1d3454a0908b430b.json |   1 +
 ...78ebc07d9f851d5768274aa605fb033205f8f.json |   1 +
 ...086b1a1f6a5166ed72528e5251de6c6ee0969.json |   1 +
 ...c05e9e2cc32eefd678abef7df2468cf727ec7.json |   1 +
 ...5119405aca3c1d652dc2487600741a7256446.json |   1 +
 ...b73416d0abd3e5180a5f043f8db24f7064a32.json |   1 +
 ...6bc2e08e4ada79161a09a7a7ac8563631e7eb.json |   1 +
 ...722db0aeb40d0a464476c6fd31994ee85d4bc.json |   1 +
 ...33951252ef9e1c92a59b8ff5f21f7e621b9d7.json |   1 +
 ...d426e56274a1a58613e08e3183fad12f145de.json |   1 +
 ...ab71faa267910f84e401902f200d7320784cc.json |   1 +
 ...68c98909e08078b9e4fa31f20b89deea0b5c4.json |   1 +
 ...eee01fc2658169071c7c5396da9c179eacce6.json |   1 +
 ...a360fa5c542d31a568fec5b62db13d327a41a.json |   1 +
 ...50beb94d650a0523c2e7b87477e512bf4dfa3.json |   1 +
 ...4f8f79d243ac5b152e6a7c6e996a672b104ea.json |   1 +
 ...f542a22b238521d962dcbec69aae302f03f06.json |   1 +
 ...194ea7c53bf16dc26d1a4463f8e32d18a9818.json |   1 +
 ...0dcf2613bb13447e9dc11b095c6e4f9b9674c.json |   1 +
 ...d2fffdb5543bf29094bb2063c392f0ae60a14e4.js |   1 +
 ...8f4bfdd95a1cdcb5192c60385bba27b4c4eda08.js |   1 +
 ...3dd1d823cdeeb343dee9cea738e069dfb565420.js |   1 +
 ...06278124e30d4897a96aaf7fff17f8e4852983c.js |   1 +
 ...807cd2a5141fe0c0f945e9024402d1664f48d2f.js |   1 +
 ...b7ff7609b47c457f094d2c89b291011b56bcc9a.js |   1 +
 ...0b5f4f039969fd0b90323b2ebddf57225724333.js |   1 +
 ...6a64c24b669773267605536157269c618f7453b.js |   1 +
 ...caff7ec2e5a14017891ef9bd5bc181e9066c225.js |   1 +
 ...beead7a057040968768aebe96199b2bbad09452.js |   1 +
 ...5bd15a3cd2c52ff5c8926e72522560dc018e655.js |   1 +
 ...ba628242011cd4f0bb566e5a815cf05422825a7.js |   1 +
 ...2ebdd94480d0f428cc116e95050f66353746858.js |   1 +
 ...b3072f0892f80671d367823439c4966b256043b.js |   1 +
 ...55abba0661bc31801cdf0a3bcd7c9a0b4597d8d.js |   1 +
 ...542ea69842ea176dd4cd781e8a285fb3d02a395.js |   1 +
 ...daccc59c0259a399214a9a09cee7d46b538b6f7.js |   1 +
 ...519a155c5e313bff9e09b81653e2578d86ed2f7.js |   1 +
 ...a71080a604c3a98346e6dfc66569ee1c4f32c39.js |   1 +
 ...818730dbff89454657291bbd4859d0cef48a675.js |   1 +
 ...c808621efe5340455500c9ebfc626dfc04db1a2.js |   1 +
 ...5465ab9f06016cbf9762057bde7edc0a9bb7c60.js |   1 +
 ...fc2c54801fc5c1b7670b484092f53107d91604e.js |   1 +
 ...8799dd8dfa5898079ad36749210a42f02f4a7e8.js |   1 +
 ...0bd6a65272b631286bac32c67813ecf885535c4.js |   1 +
 ...921a4f14d40cac0f1cab35a097fb4c482db014c.js |   1 +
 ...f29f586b03b084abb4003ec6c9cc021c9373f96.js |   1 +
 ...80b44dff6bf8d4d4be3b52807b1cea128f3cbc6.js |   1 +
 ...450af92be3f67098cd7816501294df2c1febcd6.js |   1 +
 ...65b07b35235da22347991e2d72babf2a7967e10.js |   1 +
 ...88fd1a9043a56bf45cce7f24d2b764d50bde2b4.js |   1 +
 ...4d31830f1a2f8af45f5ad3575bc308e0c34101f.js |   1 +
 ...70f7ba65e601ecf3bb4c0ba79047e131e23229f.js |   1 +
 ...7704f83da24103420d740cb9f5a6e9d8aba8096.js |   1 +
 ...141d3c4882a2feaa1e6fb9fd3fd2c94f6909be6.js |   1 +
 ...baefc1ef5ec01820d83545856e978bf6990ccd5.js |   1 +
 ...4b4af771e3f10d20e7f925c0a90144aae3286ab.js |   1 +
 ...d70360564c25e601408f37b2c081ed8d130e6a0.js |   1 +
 ...0e1dbb50db83e761951a087dcdbd34d0738f972.js |   1 +
 ...5e0588b0193d6424b023b9b3acb783c2942e482.js |   1 +
 ...3e1d0f4b3079033d393d26f1014aa088d14ecfd.js |   1 +
 ...804f43cf5f0751e176764c8d928ee4ee6a11222.js |   1 +
 ...02e761680a0c04d8daa601872c0a9fe8a41b75e.js |   1 +
 ...de6f10345bb6400da4523f2f50f4a78c8fda23e.js |   1 +
 ...539cffc60aee2f3bea99073ad08de237cdb81b1.js |   1 +
 ...d689e638d5613f66dfbf82b8e01dd9bf95ce0c9.js |   1 +
 ...a6f3612bdc1bd2f54feec3db391737928f883d9.js |   1 +
 ...6eccfaae40974310da2bf908c7f17ac7ef11b56.js |   1 +
 ...1089cdba2c5a05d14b42f9665824f7b14a1f3ee.js |   1 +
 ...170a773ce8b315b33d2f999b87683cd3b1f2bee.js |   1 +
 ...f090f6671abbdd8adeff0d10961f061c7830ba6.js |   1 +
 ...a2fce2ea6ae432df6586c39f084478daa5aa909.js |   1 +
 ...cd9c9156314dd66f85c326cdca7f5e2b8e03a6d.js |   1 +
 ...aec94d9a5633bd820911b19d773a9a8539a5d08.js |   1 +
 ...8c7c09509b2dc4ab233f2e04ef4fb96aa750a96.js |   1 +
 ...3fca459fdea2aaa77433af476d7e9f302b585c2.js |   1 +
 ...4a42d89507df038af1cb51ecb40c716a5e8df04.js |   1 +
 ...d3b3144c73bbf89c489d36b8df36b82eb3647f3.js |   1 +
 ...7cc545724c03b4f42cfc10ff8dbde1960090db1.js |   1 +
 ...abf00157d46f75471ef303fd1f3d327c0071c1f.js |   1 +
 ...b4e195236f9540d03ad70187a7adbffb60b43c8.js |   1 +
 ...921c6f26a53d45254eaf1e43afa9b5466466002.js |   1 +
 ...fee4bb35bbe734e09d62a0edbfdb642c565b277.js |   1 +
 ...0b35a1d88c73934c5dac57c428daa5f7174958e.js |   1 +
 ...0a7190e16bde7ee2010137ee171941ab301c492.js |   1 +
 ...e478f9f69409943b54831d0b1ae7e72ae91c57c.js |   1 +
 ...e1729dbaddc2478196ced444a82bdc2a2fd514c.js |   1 +
 ...2dac1a844d1df6b692a21aff7a18690f8e17fb0.js |   1 +
 ...78076987ac33781454a3a12b20e65add02060b9.js |   1 +
 ...6534006297513d7d5b54e210d446f99988746ee.js |   1 +
 ...1c1472b4662bd51e976ece4ee72a21a5b304d7f.js |   1 +
 ...ac909535d5a122007d77322998062e5e6244341.js |   1 +
 ...f4ea8ec9bdcc0fc15835306aea04a833476d220.js |   1 +
 ...7a6ffc62a6da2669464b4b5c56f8772e36caed5.js |   1 +
 ...665b54616525599eeb7ee852fb5a9f74b13293d.js |   1 +
 ...584163518fb1c21fa2d48342aac34580ad01e05.js |   1 +
 ...af3b3a275bb8c60d8c350cb7c12b6403bc6d8a6.js |   1 +
 ...36cee53154df37bc76d8e81ed30cbb48bd8fa14.js |   1 +
 ...d9f3f59c754d7695362548a32efd243004febb5.js |   1 +
 ...c4ea025f3b312748488a529da3a6f3e3ea88a09.js |   1 +
 ...8e3e2f3c59ad14dc6459778888f766fd029a8e8.js |   1 +
 ...2ef63e32d40873b034c7c5de25619a08538090b.js |   1 +
 ...5805f804ff0db6941b67d0a4097ade2ce57d595.js |   1 +
 ...70c316bb594e105fabecd7fd3a441ce7174be3e.js |   1 +
 ...0f235738fe068f2586726719253ddb97354742c.js |   1 +
 ...accd872d300ce864e9b55b1324f1f6adc725ddf.js |   1 +
 ...e6a94e85e2698b04566e231ef5d91d6cd8c1011.js |   1 +
 ...1a7eab54221e49f7326291bc8463880ce04c519.js |   1 +
 ...17b56c087f61a5f2df018e7f36c72280ce25b73.js |   1 +
 ...243bb2965f6b1b1111af1adc118e5de853b9d45.js |   1 +
 ...4ee30236ad01aa8bc80a1d270c30f34f0c02575.js |   1 +
 ...10e23dfda0b26e6804a64931ff6365698678411.js |   1 +
 ...b2b094ef8298e67bc982a98497133eee20eff0d.js |   1 +
 ...ec0d681ee7a1ef36cc383559e3ec9721feef328.js |   1 +
 ...3d1e9b7a99959e51a535976b633c858f9fb5ce0.js |   1 +
 ...a92a05a378ad5c114f8eae6c5402b22bc14dfb5.js |   1 +
 ...d413b2d48fb4c16949eb4d630b93ef40b6eb625.js |   1 +
 ...ec6980f79e4bb567b5c54f9c4b20ceb722e70c9.js |   1 +
 ...7214fd2e2ca8f8291c60b35c9378d5a1b429005.js |   1 +
 ...8d7e10518349da630e042bd591e6403d1febfe8.js |   1 +
 ...faa6309b473c03ab2f9aac665d2a1a661a400bc.js |   1 +
 ...3b719cdc738265dedc0378886b313fd97712378.js |   1 +
 ...89a81b2a0fda9294d30d1a3f231355c31d2195b.js |   1 +
 ...e08787d7e70aea6379e4b99a1ff9bed0a35412a.js |   1 +
 ...3c78f44391ac404d640e3016fae9ac51593b4cb.js |   1 +
 ...af5b0f992080deadf61103473ddc717f34310d1.js |   1 +
 ...484085f8a309d0b846234937e58fdb7c6070b2f.js |   1 +
 ...75ab5780930ee1fd43c4f84ec507446218d4752.js |   1 +
 ...7b3d359663e9e1b0be153d0c337a02f6bdd3423.js |   1 +
 ...b608b93aa09fc490e972f1da53c931c95275982.js |   1 +
 ...fce4b8f5fa50bfde284a37673f3197b4946da4a.js |   1 +
 ...d0bc4b0279ab8b77869962c31524132c3e6656a.js |   1 +
 ...37235fc85d6108172076e79c3f40457143e3e18.js |   1 +
 ...d0f29f2900440db29a7eeb4715dd2dc057e8213.js |   1 +
 ...0acd6704d7ec37b088c744fff93db2ce6371e50.js |   1 +
 ...353b201943637284711d56d0c86d7b640b1cbb1.js |   1 +
 ...04fd17421cae63011231a8a1f61e6864e703c21.js |   1 +
 ...00462f5d3f36020a3b154d9a9f5dd703e219689.js |   1 +
 ...1d7494bb15a9f538a6bf4ab1d88f83b8c2c9570.js |   1 +
 ...4b59e6d94c58713631c02368af511452b8138f0.js |   1 +
 ...818ec60751c4576b1a88219906c722bd527d9cc.js |   1 +
 ...bd588e6ee798c61af840b239f70fd17a926a1f4.js |   1 +
 ...12f43ff34c01a547f0276a0d8efd431c62bcb2b.js |   1 +
 ...c75eaff32e28b0e62306ab2969b25d6bc2947eb.js |   1 +
 ...cd8369a884cca99874a976ffc2546f5a6ccfbe6.js |   1 +
 ...96b85b9950aa292222a1e0b0a17a6662af7fcc2.js |   1 +
 ...c39ba4de6ae0a0bbbf05774e992bf66b5bf7eec.js |   1 +
 ...a22254cb0af857a6c6f5f018e516b51695dd3c2.js |   1 +
 ...11f23889abdfadfd2d78cc10939dd22a6a600a2.js |   1 +
 ...9eab35046f2c32fa2ba08243c8514a6eaa81971.js |   1 +
 ...c690659208cfbfebf8e126b0d47da5b75a3a51a.js |   1 +
 ...92ec6f07e64e7ffe8cf110d0ef2534d34bf6588.js |   1 +
 ...de6cf16e6f7fe3bd02b10fe50336c55bd7d9fda.js |   1 +
 ...4965c17c87da4f70fce2fc2d3cf1e18f79746d1.js |   1 +
 ...70778e35bdb78b63d6e33ef78f855421f02d488.js |   1 +
 ...8187a98b4c0fce65f494c509b9362b9b63cec41.js |   1 +
 ...84e985703714fc2cbb88b0735f74be242503441.js |   1 +
 ...07a5859147f7696a6b284f39d0b6a495de75325.js |   1 +
 ...e67d3faf22765ee8a95d9505966667280c32d12.js |   1 +
 ...42437564a0901773bbe502e4e3a31d21b2a35ee.js |   1 +
 public/index.html                             |  72 +-
 public/index.xml                              | 172 +++-
 public/sitemap.xml                            |  60 +-
 public/tags/index.html                        |  72 +-
 ...s_e129fe35b8d0a70789c8a08429469073.content |   2 +-
 ...scss_e129fe35b8d0a70789c8a08429469073.json |   2 +-
 477 files changed, 17436 insertions(+), 1813 deletions(-)
 delete mode 100644 content/docs/reference.md
 create mode 100644 content/docs/reference/_index.md
 create mode 100644 content/docs/reference/reference-pages/autohome.md
 create mode 100644 content/docs/reference/reference-pages/fab.md
 create mode 100644 content/docs/reference/reference-pages/move.md
 create mode 100644 content/docs/reference/reference-pages/moveE.md
 create mode 100644 content/docs/reference/reference-pages/moveExtrude.md
 create mode 100644 content/docs/reference/reference-pages/moveTo.md
 create mode 100644 content/docs/reference/reference-pages/moveToE.md
 create mode 100644 content/docs/reference/reference-pages/moveToX.md
 create mode 100644 content/docs/reference/reference-pages/moveToY.md
 create mode 100644 content/docs/reference/reference-pages/moveToZ.md
 create mode 100644 content/docs/reference/reference-pages/moveX.md
 create mode 100644 content/docs/reference/reference-pages/moveY.md
 create mode 100644 content/docs/reference/reference-pages/moveZ.md
 create mode 100644 content/docs/reference/reference-pages/setAbsolutePosition.md
 create mode 100644 content/docs/reference/reference-pages/setAbsolutePositionXYZ.md
 create mode 100644 content/docs/reference/reference-pages/setBedT.md
 create mode 100644 content/docs/reference/reference-pages/setEAbsolute.md
 create mode 100644 content/docs/reference/reference-pages/setERelative.md
 create mode 100644 content/docs/reference/reference-pages/setNozzleT.md
 create mode 100644 content/docs/reference/reference-pages/setTemps.md
 create mode 100644 content/docs/reference/reference-pages/travelTo.md
 create mode 100644 public/book.min.0072748a3c9b86d83ee02c29dc6a14c878c80458c7d3a9738747c123a4aadf56.css
 create mode 100644 public/book.min.00f308dff69f3e9b87ad0befdbcae2dfaa63039376cd11fa6146fcb8f19254b7.css
 create mode 100644 public/book.min.0233dfe37a3eae590cd2057b8ccdf95ea6927737137f4934b3c5210b9f5c1f83.css
 create mode 100644 public/book.min.028072389c1d8c27b05c13d81f213e027289287344d4c842ad8288fcae3a33c0.css
 create mode 100644 public/book.min.03c75efe4b9229a2b35557b34300ef04367384144e4be93ae795aae7125a8cd4.css
 create mode 100644 public/book.min.04c76e5278fa305bb5cf9618e5ff076605273ff1728c17934411a2a02255c638.css
 create mode 100644 public/book.min.05e957753b405d5980f1f44467e3d64ad74fea8a4f755d12ad3fc922c31fa1ba.css
 create mode 100644 public/book.min.06ae87669601e13856b80a5bebb33e745e295bb1e88e3582ad1cb410caf63e24.css
 create mode 100644 public/book.min.0808bd7baf39a6d6fdae7cbf06a6f30705e58bd43123a27d6aa2cad3008f4d03.css
 create mode 100644 public/book.min.0c8d7080bdb93407acb48e9efd8fc650050f3280290baf3890750bd07e82e22d.css
 create mode 100644 public/book.min.0c943900a23c33b97e678833b149091d16e20ae29f03000b15f96b68e046fb66.css
 create mode 100644 public/book.min.0d90e0e3aee6a460c02a1897d0d660497878963a10f908f2f287a4b02d4786d9.css
 create mode 100644 public/book.min.0e42c4a26385c5963931b1b7bec4511449ae6ae6dad81aa4ae8de6ab4812a730.css
 create mode 100644 public/book.min.0e9d2249353d535c71ea22a05afc282bedd08b8a78691f790263abeb68543b58.css
 create mode 100644 public/book.min.13a65314c2279f13333ba7ccd5f931b7c4c9567742e4dc280f862d6bc256f2ec.css
 create mode 100644 public/book.min.158fb632e46b83994fe092523aba614621b1414122d22def9867c8ef97cbd1ee.css
 create mode 100644 public/book.min.17de8a2f0f1c3a7eb9d94c8abcc312161f8d2e49604b42b65a0e77ed959666e6.css
 create mode 100644 public/book.min.1d0249775b1202c41220519c987d00ce7a9d0cdbdd7f2997a49c050443c97961.css
 create mode 100644 public/book.min.1d76fde1d64081a8e7c6c7bf431132b5f99d8e5e7766c8b74649413f9c2bba4a.css
 create mode 100644 public/book.min.1e9436a0c6e26c00ff3ad8003457f177f94eba1bb28e5ceb37f7fac177a28364.css
 create mode 100644 public/book.min.1ea03809235b650ce69038dd075dc4ebc4ee1900da5122d21d790a60f75de8b3.css
 create mode 100644 public/book.min.21d4a3dfbd5b7a6675db53f2bd23b4e83e77c69f85290fca9fc894555f7892c4.css
 create mode 100644 public/book.min.2539fced13c1e5377874d9c0c17917a902e6f0b8cc48305d9c0932daee67a05e.css
 create mode 100644 public/book.min.27f1c8233e0f81d6b57565d975a13883ea8af36fc02d099db5c21afa2edb0af8.css
 create mode 100644 public/book.min.2b3fb1b9fae296316b75333bbbadae4800964136df28327ff0bf24616c0038ca.css
 create mode 100644 public/book.min.2ca27541230e4d4524e24a7dedfea6b13e89c16ee5853f8a54abe6fe325738b6.css
 create mode 100644 public/book.min.2f7c6b4f2c6a85108b7038fb4109119fb94fb6c11c1b3210dcc2db68e3a318e6.css
 create mode 100644 public/book.min.3799e8906eaebb64f51edda147d06e333d5bc0012219bb61df4eb33975a242f8.css
 create mode 100644 public/book.min.3839fefeaa4f521b6ae63e62264dfbb1af36de53744d3a1856962e774d29b005.css
 create mode 100644 public/book.min.3ad3af9d24d642b875cd453f3d2ab6bb0840e57e347335ecb3db9ae6b34f5cf5.css
 create mode 100644 public/book.min.3af860061526e6bfcb2de3ace1a403b45a7f1b1f1a4257f32dbf305dd22a0453.css
 create mode 100644 public/book.min.3ca8c8ba07a84f4e78165a553ed24d049467143106f678c901012be17613c243.css
 create mode 100644 public/book.min.3caff1cdb1c0e626deb151656ccfc0f394c3dfad0396701122600d6093339ef4.css
 create mode 100644 public/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css
 create mode 100644 public/book.min.443261f7ab53cad405f065a6f1c1cc84b8d139f95323f911bc1a08177148ace5.css
 create mode 100644 public/book.min.4676687a6b6213d7f7a067e5274431246631d9dfaca74182165a8ab43f88eaf7.css
 create mode 100644 public/book.min.47a14214c48deadd5aab5d135d4f9360f936f281cddd7b22470c8d82871b42cf.css
 create mode 100644 public/book.min.48017641984d0492bb1b15747ebffbfda16067dfe0f135879b6a0dc312c36124.css
 create mode 100644 public/book.min.4946d1be45d0a8c0d823155d8932ddb6d9c8255c2afd646dceabf79e434bd8d6.css
 create mode 100644 public/book.min.4b1e6033c8e8c4621852c9288349caddfda8351226bd8f535de671165cc485b1.css
 create mode 100644 public/book.min.4da2860eeeedd961343692b8958597cb0840071f11dc2224b89dab98c007fdbe.css
 create mode 100644 public/book.min.51376eee9ddaffeab3dfe8853fb9357ec9434e5702c4a923aed5257b2b035b77.css
 create mode 100644 public/book.min.54d2a25f48eacdb10939e523d045eac4b9b2e57ffca4692a0bff064b8a96511a.css
 create mode 100644 public/book.min.5502b34620e12e7c1e4d4053a7547a4746cc0a5bc05f817d410053a1f569ce23.css
 create mode 100644 public/book.min.57890adbbfef6924de091c07d1811e85275c09d423c856646bcd54adefcce28b.css
 create mode 100644 public/book.min.59c28be0de71eaf9ea25e02a8500e39435936e3e85a58a2545a515cc1419bc76.css
 create mode 100644 public/book.min.5a812bb0f5ab2a9bfe55c303d46c73a64c417e37a8e795002394d80704f78ed8.css
 create mode 100644 public/book.min.5b6d51bcc51bc04792507df0cad46a63ae47fd1987793ffb1cd76311de785de8.css
 create mode 100644 public/book.min.5ce2b8478174d06bf99294ae08b4901564c67a81f93a20b871d319023d81e9d9.css
 create mode 100644 public/book.min.5d49f7be6c1c4ecc5ecdabf17bc22eb97de6e5180a04c5573a741afe0beb4672.css
 create mode 100644 public/book.min.5fd603082890a909136ef6c5c5431a4bdfad3f52da0b692e10e211c9ea991408.css
 create mode 100644 public/book.min.61479c464d87c76806c0d40d5d45c0ef3b99886dfb028a0be7e29b28b913c6f7.css
 create mode 100644 public/book.min.637eed593001710b067ff3937fc02ae912709b5c530451b9ab0f8c55292bbf0f.css
 create mode 100644 public/book.min.6a8bcdb87b2d5ed74bc6c6b905c85749ca36be6f2b4635b070ce2be57053aec1.css
 create mode 100644 public/book.min.6dd25fbc3304a7035075a440a03a30c9a002e97e28b4cd2d2d9855c7c9088169.css
 create mode 100644 public/book.min.717e02068d95cf79fc4a97fd9cd56cf4f3b70eba27526efb5c6a9d1f2cb825a2.css
 create mode 100644 public/book.min.717f4d6769abddfa055a6b7965889fcbdfb7d78b0ae53125682012ff5c666381.css
 create mode 100644 public/book.min.76929abc828634b27169df8085c79eef4b1adc123192b661f57c33c92b977c28.css
 create mode 100644 public/book.min.76ae6f26e43834193a289bc4801951c91e9504cd09c4bb64abccc6e7650cac73.css
 create mode 100644 public/book.min.76da4a9ad7088e0385721856550b87762480d7ddbb0e2c12b3a561abda21e224.css
 create mode 100644 public/book.min.7bf4d6ba9fab661fdcf1a25c6d3162f88fd2bded862432ca9207e7fe2e344341.css
 create mode 100644 public/book.min.7ef099dcebc07a2aac232bdc5211e8caaee64db782fc6509ea85d690eea99b71.css
 create mode 100644 public/book.min.820e4d97bf8106897da2c21925c5595066754edc466600b61e9d236ad2e6ce7b.css
 create mode 100644 public/book.min.88c57e9e45b2b3f81722d8bf8a09668d1c7aa866d348fa5d8135a7a82baf2f5f.css
 create mode 100644 public/book.min.8910f50bcf80173a3843f7c7516c6ce8c0d41ad99b40352bfae88dad8e08444c.css
 create mode 100644 public/book.min.8916f1215ac11c215525244ead872387d966ce05a7f32222bc72ab74e700f16d.css
 create mode 100644 public/book.min.8942f18f54b86461f638cf18e8f23061da7a44cfd27d8160398610c4f6105ff7.css
 create mode 100644 public/book.min.8985f01ddcc5570565234ace16d7bfbe1a96253aeec50fe30888392189d8e978.css
 create mode 100644 public/book.min.8a42b64d326ced9c7104d19fe9eb2747a7213ffa031f01bee26c4ef1b2691362.css
 create mode 100644 public/book.min.8c11d334769080437fe0788f17987361c62ebc9877946527f372331bcec1c639.css
 create mode 100644 public/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css
 create mode 100644 public/book.min.906be3c02a9f7b255ca5dd9efeaad8a43cc8dd29a6447b8a06f63fd7ff0b859d.css
 create mode 100644 public/book.min.92082d667237dd69bf8850f78cf90dc5f45ac8d1f74c2b34f70af6a4e2911cad.css
 create mode 100644 public/book.min.93ae5b81037f40292f959a8ce792bd0bc8f5eb40cafb0ef9be4e796399869921.css
 create mode 100644 public/book.min.94f7832c0f6b467ce82af835f857dc8dacea8a0ca96f464d2df0f896ecc4a6ea.css
 create mode 100644 public/book.min.967f0dea362c19f3c83c6ca907cc3a9298e6c7549c4bccbc954d9079e2dc7bdb.css
 create mode 100644 public/book.min.9b3e0f300a0ab4c4af5071af879388de75b2fb08f9985369711762efe01eb232.css
 create mode 100644 public/book.min.9fd0b56cfc68da4ef0e88078825e9e631d0756ff04ae6f600e638bfc4b853335.css
 create mode 100644 public/book.min.acc09f8a75ce621f794117226fdaa777181171bba8048e2a2769c9b05348eed1.css
 create mode 100644 public/book.min.ad941185ec672ff4e5f02c9bcc02bdcea1dbcea6b15b088bff9a96da40b8bcef.css
 create mode 100644 public/book.min.b5a6876a3021b6c0fc9690f7553828e2d022621bc3a1ea039b9d560f59d0c39b.css
 create mode 100644 public/book.min.b67de44bd6dabbba8d0cac1f4727c3b0373e09fbcb1d4dc9c9e393721950b9f3.css
 create mode 100644 public/book.min.b727ba30f5db58d410a60a05642b7bbbf9e31a0ef79c47246dec25e32187f47a.css
 create mode 100644 public/book.min.bec96ec420693661723d4037d75485a06b434e976c449542c14e66609bd098eb.css
 create mode 100644 public/book.min.bf33e025446443a4a8bbadfbc95aac19489e510d092c8a796fb1949e4c5bb4aa.css
 create mode 100644 public/book.min.c01a3f52457b938f995994f2db80632b7a9894df67a6364cd8e49e47be935636.css
 create mode 100644 public/book.min.c2d5b829467d9809f85bef6fff45226e7c3c500a3ec7366fc01d03e80cbfe80e.css
 create mode 100644 public/book.min.ca4773c7d802def2ce0a306e49a36ce75a40835f84f4f752adeba935845dc967.css
 create mode 100644 public/book.min.cbb9dd6f56abebda9e75352b5ff02226a1b1f278df3eedf92bd3019076a156ed.css
 create mode 100644 public/book.min.cd9a024b85590e39ab9fd299169260ac9f2cf9252e2c591081be91cf2d66bdfe.css
 create mode 100644 public/book.min.cedd874628e69a6da2ee528341788ae001afb7e2e7babce01263b2f3d021ff06.css
 create mode 100644 public/book.min.d076dcf8dff6714cc85ff6f9d2a3387666e734785959f37b7448525a983e3774.css
 create mode 100644 public/book.min.de6dcc60710807ef9a1cf5ba94d281fb97478fd32ae8fae3cb78d85dca723788.css
 create mode 100644 public/book.min.dfc0d503e591842fd27120ac0a3962c32df6cbccc3abab8194fbaa9602e53ed8.css
 create mode 100644 public/book.min.e25dd85b3a0c23cdac7b33c3701bb4f3b50031d3708af8624945c5a601395567.css
 create mode 100644 public/book.min.e4855f3ccb7c80afa9ea474950ae2c146f8d7e3f5f456ac8ef61366ac0608b02.css
 create mode 100644 public/book.min.e5a50029783f9371bdaf86e62cd63c01e97a2f65b011d3d31c79322eded67ae3.css
 create mode 100644 public/book.min.e86ce09cd11e0ad6c87a449244a54affc097e820e189d1fdcf110546267b104e.css
 create mode 100644 public/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css
 create mode 100644 public/book.min.ee92c3780008de58e5dc136186d81f9cfff00747c98c3c1dae5760bf04fba8cf.css
 create mode 100644 public/book.min.efcd5f8aa554ddde02df57396d583a6abe45c9bb8cdf8442c643036ee0a2cb49.css
 create mode 100644 public/book.min.f0844eb1b9e55a1aa15f4c4d9f6cb2aed7ea3d74314cdca1647f15d7844ba1d8.css
 create mode 100644 public/book.min.f2da846ba9519b6a846b25fd020cbe9e2381d8ad83405398926710832ec4cd03.css
 create mode 100644 public/book.min.f356260cd2018e7a47c8ccef1b94bf6163837f7a78f7ac216d84f4aad582c273.css
 create mode 100644 public/book.min.f4d31c2d5be8d50501be2328c698193fe04941af6a3419d9fbcdfc964278fbb3.css
 create mode 100644 public/book.min.f7f8e1820da58a1734a943e7dd04bbc1c7e333ad0f64c36fde411a29c5fe6997.css
 create mode 100644 public/book.min.fbbf1a6fbe7d24be4f07633b9a257bc9272599fdd6ecfae80245e666a57c7b54.css
 create mode 100644 public/docs/reference-pages/autohome/index.html
 create mode 100644 public/docs/reference-pages/fab/index.html
 create mode 100644 public/docs/reference-pages/move/index.html
 create mode 100644 public/docs/reference-pages/movee/index.html
 create mode 100644 public/docs/reference-pages/moveextrude/index.html
 create mode 100644 public/docs/reference-pages/moveto/index.html
 create mode 100644 public/docs/reference-pages/movetoe/index.html
 create mode 100644 public/docs/reference-pages/movetox/index.html
 create mode 100644 public/docs/reference-pages/movetoy/index.html
 create mode 100644 public/docs/reference-pages/movetoz/index.html
 create mode 100644 public/docs/reference-pages/movex/index.html
 create mode 100644 public/docs/reference-pages/movey/index.html
 create mode 100644 public/docs/reference-pages/movez/index.html
 create mode 100644 public/docs/reference-pages/setbedt/index.html
 create mode 100644 public/docs/reference-pages/setnozzlet/index.html
 create mode 100644 public/docs/reference-pages/settemps/index.html
 create mode 100644 public/docs/reference-pages/travelto/index.html
 create mode 100644 public/docs/reference/index.xml
 create mode 100644 public/docs/reference/reference-pages/autohome/index.html
 create mode 100644 public/docs/reference/reference-pages/fab/index.html
 create mode 100644 public/docs/reference/reference-pages/move/index.html
 create mode 100644 public/docs/reference/reference-pages/movee/index.html
 create mode 100644 public/docs/reference/reference-pages/moveextrude/index.html
 create mode 100644 public/docs/reference/reference-pages/moveto/index.html
 create mode 100644 public/docs/reference/reference-pages/movetoe/index.html
 create mode 100644 public/docs/reference/reference-pages/movetox/index.html
 create mode 100644 public/docs/reference/reference-pages/movetoy/index.html
 create mode 100644 public/docs/reference/reference-pages/movetoz/index.html
 create mode 100644 public/docs/reference/reference-pages/movex/index.html
 create mode 100644 public/docs/reference/reference-pages/movey/index.html
 create mode 100644 public/docs/reference/reference-pages/movez/index.html
 create mode 100644 public/docs/reference/reference-pages/setabsoluteposition/index.html
 create mode 100644 public/docs/reference/reference-pages/setabsolutepositionxyz/index.html
 create mode 100644 public/docs/reference/reference-pages/setbedt/index.html
 create mode 100644 public/docs/reference/reference-pages/seteabsolute/index.html
 create mode 100644 public/docs/reference/reference-pages/seterelative/index.html
 create mode 100644 public/docs/reference/reference-pages/setnozzlet/index.html
 create mode 100644 public/docs/reference/reference-pages/settemps/index.html
 create mode 100644 public/docs/reference/reference-pages/travelto/index.html
 create mode 100644 public/en.search-data.min.00e40082f8fc8cb6a922a8b64004e43073b3529d0b5cfddc90692fa868fc35c2.json
 create mode 100644 public/en.search-data.min.029e88f856b43e6755e9b4b8eda4badc7b7913d64a4ed055dea05c5b2d04446e.json
 create mode 100644 public/en.search-data.min.03f3c1ecf90ff6b881143e6b0097e69bd76e5c051cd3ee6e27416d40471231a4.json
 create mode 100644 public/en.search-data.min.048ef4df4358980e4f119d4036c3fc0e6a6a21fd9d2158798630e30fccbfa641.json
 create mode 100644 public/en.search-data.min.0745cdc6706f1058d039ebc7a5133c574c68fffa371091bc49bb66cd064a724a.json
 create mode 100644 public/en.search-data.min.07da1c07887873ff0ed10034829f7fe104d2733eaeaf7b7d05a2333e7025a671.json
 create mode 100644 public/en.search-data.min.0af9bb263c482228c0bb0ef7873f8914acf1dbfcd47a07db3991689d11479374.json
 create mode 100644 public/en.search-data.min.11970372873f60a48f95e439cffeb1c837eb8987f710edb230037cde896c3f5f.json
 create mode 100644 public/en.search-data.min.154f7a8647a8102e314414ab527155ac0269d10f548c9349f17900f8c7f83371.json
 create mode 100644 public/en.search-data.min.1556011805b59dec4ab3d9a0edf74207a27381ebeed46abd8f9d36faca646b33.json
 create mode 100644 public/en.search-data.min.165780119ee4cfe69ff1bd1b15899881ec0273271360f28f28435bd07f28fdfb.json
 create mode 100644 public/en.search-data.min.1be1adeec26200029d2af9a07cf8a54f33223e7e0614671cc64d036a8bd5a8f3.json
 create mode 100644 public/en.search-data.min.1de78ec5fba7c2a50151baf821e0a5f18b7840891b83f26f6faae6426c099e46.json
 create mode 100644 public/en.search-data.min.1eeb3810eb70dcd6d62a8495adb9ce9f941e9def9bfe3a1c51c48c886690209c.json
 create mode 100644 public/en.search-data.min.2421ceaa5fa80dc1237e0e9889791a108f8af987ef2aed3b18896ca71eba91c2.json
 create mode 100644 public/en.search-data.min.26795fc419a12ac32226be7f350e7cf2096763fe62c07363914d17d8b1ac8e56.json
 create mode 100644 public/en.search-data.min.29602cad1fc3d0a6b21fe32f1fde21eec0b0505476aa0ee7cce39ce71cb8ab16.json
 create mode 100644 public/en.search-data.min.2fcc4604322f1c298722042c62acc0150432fc6de5d2a5d242641dad06adb3d2.json
 create mode 100644 public/en.search-data.min.304a294d6fdc89c7603281b295703c248a93d226a4caf7343d1b27f009eadaf5.json
 create mode 100644 public/en.search-data.min.3647847fabb48778a5ad3e98493e2838298caf75461c71e11c85e70c64a9e60e.json
 create mode 100644 public/en.search-data.min.391017a502c7405bf4023c4b4bd23514324f48a3d4503df2789e1ee031fe8d90.json
 create mode 100644 public/en.search-data.min.3e93869b101f92aca860e2afe0480bb2c84c4292d5bbddc6488b39aebc01fcc7.json
 create mode 100644 public/en.search-data.min.445d8a4c1c2cfc514578b8de5e1a255447e5f3ed79c02231fa561f469d6fb4c0.json
 create mode 100644 public/en.search-data.min.45287d4bab40c91556d0ee400339d653f8b533533fac5465d32398e76b03b8b3.json
 create mode 100644 public/en.search-data.min.4675156f2f815ac19439aba9887f4797c070e5b270ba38de6ccc3a4818affab8.json
 create mode 100644 public/en.search-data.min.48cb37053681cb6970cb4fa9938e19c1d9e9a0feed8ca5eaea4bfc8a798ab026.json
 create mode 100644 public/en.search-data.min.4cd73e6faf0a4832708bee25e9cee2e922f6b9acc960cead3e744a3d329e8035.json
 create mode 100644 public/en.search-data.min.509c32f44d58feb440f3a80dbffc45f22f075676b5aa4026d1babde6cd5b9615.json
 create mode 100644 public/en.search-data.min.55786e98b357d542b9a9f1ebdc64f3a9cef1bfa7e7b929136564bec7b8d38e13.json
 create mode 100644 public/en.search-data.min.558a1fe6ec355ea263b1c72da9b076f4f30b599a70f896650925a0ff96716a34.json
 create mode 100644 public/en.search-data.min.565be0a4658598fc23d864f16a924b0d9c2324950165061c798e944d6c336f53.json
 create mode 100644 public/en.search-data.min.5bf89274dab7957218d8709c907e0da8a8c5e52a0a535f6150bd2972fb74f744.json
 create mode 100644 public/en.search-data.min.5fa0a25113e01e3f1618a9614f0ef7fb9d331a4f03d4af45671d21e60b53678c.json
 create mode 100644 public/en.search-data.min.5fc846aaf33df5a2c9bfbc26c1f95a12084d32e0442d5a1c8f6c398100923946.json
 create mode 100644 public/en.search-data.min.5ff007a54a084d92bf0714481a15343d45fc205cdcfe5f00647dc98c5d553336.json
 create mode 100644 public/en.search-data.min.60207e4f0aa5d2fad2003bbaabed610c01aabdf07db05aea4431ae292667aaad.json
 create mode 100644 public/en.search-data.min.61d5e44622e0ab52daa1d875fd37dba3ff5f0c40dd4fb0c1c0ee9258275e496d.json
 create mode 100644 public/en.search-data.min.6445f0a0beb9c7f367316a2192ae26de3fb58161f9edddfc9c94620923320aa7.json
 create mode 100644 public/en.search-data.min.6499862a64d277340e205c881fe65582ab1f36f9eefc09396ef53bdac0d7317b.json
 create mode 100644 public/en.search-data.min.6546c45c925b5659b8d98ca778e860d2f02ad8c70b75ee5864ded5adc3a67fa9.json
 create mode 100644 public/en.search-data.min.6577178d88c8978f5ae22e93c7dcb991bb5ac3970dfe6ecc444bdb7ac39e22d0.json
 create mode 100644 public/en.search-data.min.65d015c500b7ca4aa2427d4f8051a29a701136efbc50403977ab87f648665f45.json
 create mode 100644 public/en.search-data.min.667e964f283eef6242dccb5942251655146e4b0cb5e259b0803857931ce18cee.json
 create mode 100644 public/en.search-data.min.66c5937d497e0ccf53cbc616e18b843aa5f4347ba038182bf0293ad11fa91ccb.json
 create mode 100644 public/en.search-data.min.6a61eb24f5e6c6205b4947d8d855387a9c63d0dae18887b9b660fdd40fe6bf90.json
 create mode 100644 public/en.search-data.min.6af851c1ac65c501a9485c83928656edca91be2fec79d3d2492fb610fcee29c0.json
 create mode 100644 public/en.search-data.min.6b6b2b9842106379ea9ce4b07549d219663514e6bd370d1fefb6cc4003665bfb.json
 create mode 100644 public/en.search-data.min.6bd8dd9b711b40d5bcda4fab6fecc6369b593e82312eb8deb610820805be14ad.json
 create mode 100644 public/en.search-data.min.6da35d1b7873a492a19a63b1a6d7a866eb1c69bcd4db0c41f91422935ef10597.json
 create mode 100644 public/en.search-data.min.7128648673136f428e4e08e8623df06e4c5452a789b703f2415781ec9f13e036.json
 create mode 100644 public/en.search-data.min.718e03783f5efc75bbb2edadb7d0244fe0660f2c3c34d47689a4817cbc1c5277.json
 create mode 100644 public/en.search-data.min.71e69686733f1371040b0e096c71646444c02394a04d1f3d5cbd08dd169ed98c.json
 create mode 100644 public/en.search-data.min.7337c013d8f9b84d3b7fd99a0f53f1c23dd63f493ee6aec2551998b717186cee.json
 create mode 100644 public/en.search-data.min.7375df6b62db53129f7a7d4733d0976a055f0ed41df653a39a82859938ffde6f.json
 create mode 100644 public/en.search-data.min.73fde574b66c5a1ae260c1ff8cab0161cab328c29957a53f4f0eded5b20e2dbd.json
 create mode 100644 public/en.search-data.min.772214b603eccaf257495902ca09daa59bc1f8db14bf27672640d0ba4b0a5637.json
 create mode 100644 public/en.search-data.min.7830d52e2f16f74b9b7c45522763a41e206663e7aeb268e1ffe69f1610e3a6c4.json
 create mode 100644 public/en.search-data.min.79ff799fcc7040c6b45c0e3ec2374f07bec15ba12622a7a3c0ca79b37b4e00fa.json
 create mode 100644 public/en.search-data.min.7d9dd6105ae5375618d9d0241abf45e8c1dd525876f5df2f217a332e7b698b01.json
 create mode 100644 public/en.search-data.min.7e95d980c3282e4b0be2b9adec314ebd13db1bc4a0ed4a1da8af101c8f211c29.json
 create mode 100644 public/en.search-data.min.7f321d667fb9e48f584f17ac1e71faba6cd7df99151431b63318e328cafbffd8.json
 create mode 100644 public/en.search-data.min.801a6a757cd9a4a9499d57cffe098df09a4a43689412b4091368c64f1b9ea204.json
 create mode 100644 public/en.search-data.min.81905bc2c4cd8c52929d625a6633dbf5be644a50ef023e6ed6d8403bb0e3af8f.json
 create mode 100644 public/en.search-data.min.83c0aed0d8ecb36136e091e4caa0b03bd83d734aaa6dabe48149f256251d788b.json
 create mode 100644 public/en.search-data.min.860e6fe1a873ebe98edd5b07f77b615f4f8d5b8281b6fc1c2a3c7cb4044fbf8a.json
 create mode 100644 public/en.search-data.min.861af178428f7141bab3f1ad83c730053f4c81847dcb660ad19e42c63c9a444c.json
 create mode 100644 public/en.search-data.min.86ecc0111a008bff2b6a31dc9f682dd09dc094acf6ded34e0942911f94a080b1.json
 create mode 100644 public/en.search-data.min.8849d2cacdbcf52d9292b8c6db6763134c296638d2450011a7cad46facae1b7e.json
 create mode 100644 public/en.search-data.min.894e3518b4efd7e1b26bca6ecc152fa01a89ed8be9a761723befcefe87497135.json
 create mode 100644 public/en.search-data.min.89c0d4264a9e860a6c4cb0d8a0e8840ce657e3d0cd963becc81d1d5448c3c030.json
 create mode 100644 public/en.search-data.min.8c19a39b7953525530ca513578ac8304dfb364dca417ba356000e0c617c0eb2a.json
 create mode 100644 public/en.search-data.min.91fd0cbad6736a636b94cfca254e3a815f6627e00d11557be52a99e5b1a44231.json
 create mode 100644 public/en.search-data.min.94968468ff8b46624548373c43591a7a34c3906249e666635e5e5712bc39b4cd.json
 create mode 100644 public/en.search-data.min.96a560e13c0e945062164a0eede07db68559e25265ea9a4daeced86b305b711f.json
 create mode 100644 public/en.search-data.min.97b0bb8f87c4d1219d3160d213583251311b144cea0763e2283cf364553113f2.json
 create mode 100644 public/en.search-data.min.981a159b15887545282b1b960b4b0a1e5ae1ce30723a81e6e9cd45328ea1d46c.json
 create mode 100644 public/en.search-data.min.98bbde77c8be30b70ea2b56f6142d73640d8cd5c773fc19c26f15900f321438d.json
 create mode 100644 public/en.search-data.min.9a42dad56111450c33e67bcedc9fdde765cd64ce3d49651e2b9b9bc9959b1f61.json
 create mode 100644 public/en.search-data.min.9c75bba4a8ea5c57659bb7bef01fbb932f699ea27e97f71802fb46e2b7fc0b07.json
 create mode 100644 public/en.search-data.min.a0545dae98cbf4cecedf3878fd3fa830b28f77cf9efd8699e84043162133b030.json
 create mode 100644 public/en.search-data.min.a2f9a6f5c36a7330722b76867f3413a4eefd34aa3bfa41259825737e2d5b9566.json
 create mode 100644 public/en.search-data.min.a38bacd2505c23ef42f1f9abd28ed86f95ac0dff3da3ea7a7c40e461bec826e0.json
 create mode 100644 public/en.search-data.min.a406ce662dabdb1249a9fb4a1a02502ffb38b06e0a460e7a2f082cfedfe90af2.json
 create mode 100644 public/en.search-data.min.a8a9e17cca1b7fb9a055d3771c1fe3d65160bfc63090e47f3c1c06ec3746066f.json
 create mode 100644 public/en.search-data.min.ab470f4d6d2e6dc40dbb80009279282d69a20863acd3c536e7a03dc912bc3b9c.json
 create mode 100644 public/en.search-data.min.abe4ddbf007062948fa99a7be7a45bd457430d82fce36d01b81d3b26ad8de96d.json
 create mode 100644 public/en.search-data.min.b22d38864b7bb570f898add170d5d604d0802cceec1e58355361d744d59891d6.json
 create mode 100644 public/en.search-data.min.b25c9a14aa028cd957e5f64d43b8ee801354d45cc5867530a965c6dcda605ebf.json
 create mode 100644 public/en.search-data.min.b3397ef9eef083de5eb7c1237cab9a101c29b65506def9dbcb2c9419d4600a95.json
 create mode 100644 public/en.search-data.min.b7c7a96f8d3894b028594db37e5f6ad4465953a6469ea180e4ef2c8c8cbd8ae2.json
 create mode 100644 public/en.search-data.min.b86107c2283ccf4dcc7c1c084d4b0da505310b8bc00c5d213273b3e64b8a82c6.json
 create mode 100644 public/en.search-data.min.b8694d7f275c2bf95c26f68f7835d3df004cd5467cd751f7325ec7664324a5b8.json
 create mode 100644 public/en.search-data.min.bad9fe840129bc1af5af801d913f6e4571b96d65a99e8f22c84a185c8b2cb035.json
 create mode 100644 public/en.search-data.min.bba190c71a3a3ce31d639c79c1fa94ff070e7d5643793d3b6875fb107ff215e3.json
 create mode 100644 public/en.search-data.min.bbc5e819b180288b63890162d58d58553187d1fa7d90555abe3b69363269277b.json
 create mode 100644 public/en.search-data.min.bbc9f13e84fb2a17ce054c9d6dda33f30d41b11a84c7dfd7479e58999931f39f.json
 create mode 100644 public/en.search-data.min.bf0a000c9c7900b4bbb10dd12183db31d89992a82f52bbfbd3f79483047786d1.json
 create mode 100644 public/en.search-data.min.bf22df4eaf43889158756edc9fc7e00ff81fd4ab33add9c82975300375f2a593.json
 create mode 100644 public/en.search-data.min.bf76fe20f9f42249feacb637fc7dd0e32c62bc43b08e4db4f825ce94b0cfd608.json
 create mode 100644 public/en.search-data.min.bf7d16b96ff0e16e63078f2958be1be6badfd87c89aebb5e209c17ae29497a67.json
 create mode 100644 public/en.search-data.min.c00e23b94e00aef0ef43af7fddf4b6251be839876c1a0db228a0617d6ec5f446.json
 create mode 100644 public/en.search-data.min.c0bc7529c23a3bec1b623fb2de6635ceec6db987683d966ca13e6f16263b49ae.json
 create mode 100644 public/en.search-data.min.c111c7ac0d90a67c67b55c838b974c84f29c50bee03187afe1288aab7e21ead7.json
 create mode 100644 public/en.search-data.min.c225043b57c5852126722f2f3e68ac819e50499408f143203e44e3d42c1cd049.json
 create mode 100644 public/en.search-data.min.c2d89b39a47110b577bde5ec2da55d97a8e04cfc34b38e31dcda5c5bf08baed3.json
 create mode 100644 public/en.search-data.min.c2f86be8bf35861faf90fe2214bb523b50b018784c4d43d3b19640c6721f8968.json
 create mode 100644 public/en.search-data.min.c47141e51cf0062faf101fb98b697b8d9c5bfdcedf2aaaf965c1e57d06953df8.json
 create mode 100644 public/en.search-data.min.c4a49f772fe1c88f3394a5761bcc3b6433a46cc0a8709d3ace6f55fbf48b6a32.json
 create mode 100644 public/en.search-data.min.c59b621fa81c9a3047dc1dfc53456d494adea3c6fdee8ceef49f1ae80c8dc306.json
 create mode 100644 public/en.search-data.min.c88788fee0bbc6f8d202ce2ad9652258561894883a4c2b22dae8ddae27595333.json
 create mode 100644 public/en.search-data.min.c98160a9b56ff966e31e1ce84e7b583611a3fed8658bbd6c80944f3b650b7ff0.json
 create mode 100644 public/en.search-data.min.cb92a71bf272108022864f9f81217f340a3281a7cd6c85c873b240b72e030c34.json
 create mode 100644 public/en.search-data.min.cd39fbec43262cbf79031d0910fc82273867662ce5240c50a65a93cba1c6850a.json
 create mode 100644 public/en.search-data.min.cdd6382fdba5b5d12d1fa5fb9e8d6c93f835666d942dc95b2d6f8e9a8f9aff06.json
 create mode 100644 public/en.search-data.min.ce8f33773aa20e2c8eb5535db54d153816affa6e897b7fef2a8a5bc80e8912d8.json
 create mode 100644 public/en.search-data.min.cffa6a43531f5ca08beb6e22130e6263b113e49c35e26912602aa5188313d167.json
 create mode 100644 public/en.search-data.min.d057f8359fb3efbd65017ecdeb9701734e00b22ccc57302db0f19b0c4da71648.json
 create mode 100644 public/en.search-data.min.d14b1592fca23d09b2af02b33cc42a9d66ff059f80905c483f47d8171942ebbc.json
 create mode 100644 public/en.search-data.min.d30b612b163525b92e973de2f067a3eab76e39bc629cbc1fff8798ac022a0978.json
 create mode 100644 public/en.search-data.min.d4f9e6c23843c83e22e57bb5d046c11d0eff7c3c7421f1d2e863ce7512619ae7.json
 create mode 100644 public/en.search-data.min.d8f743668bdc5397a6f0cca3c13f3931f00a4e92368f7bb01944ab605d59f29a.json
 create mode 100644 public/en.search-data.min.dbdc6ea5d40b528b04cd5caa2d60eaddbb9451c7daeb9c5e1d3454a0908b430b.json
 create mode 100644 public/en.search-data.min.de70110fecda8d49639e7b6369078ebc07d9f851d5768274aa605fb033205f8f.json
 create mode 100644 public/en.search-data.min.df4e720b1747d218c92bce0f962086b1a1f6a5166ed72528e5251de6c6ee0969.json
 create mode 100644 public/en.search-data.min.e1edc0ad3c25cc2662de94152abc05e9e2cc32eefd678abef7df2468cf727ec7.json
 create mode 100644 public/en.search-data.min.e21491cf6b15f1b52f0253f4a135119405aca3c1d652dc2487600741a7256446.json
 create mode 100644 public/en.search-data.min.e34a9d4facccf3d3bb7b409858cb73416d0abd3e5180a5f043f8db24f7064a32.json
 create mode 100644 public/en.search-data.min.e5ba47ebfe13fa9164ce2c9fd1f6bc2e08e4ada79161a09a7a7ac8563631e7eb.json
 create mode 100644 public/en.search-data.min.ebd9dd9d03d1a0e52c3fc81573e722db0aeb40d0a464476c6fd31994ee85d4bc.json
 create mode 100644 public/en.search-data.min.ec643153ef99305dd7d4bb0242b33951252ef9e1c92a59b8ff5f21f7e621b9d7.json
 create mode 100644 public/en.search-data.min.f02035e061c96821618e4891f0bd426e56274a1a58613e08e3183fad12f145de.json
 create mode 100644 public/en.search-data.min.f063290de814ec014ceed7c8c08ab71faa267910f84e401902f200d7320784cc.json
 create mode 100644 public/en.search-data.min.f12f516702011e6c3de6702318c68c98909e08078b9e4fa31f20b89deea0b5c4.json
 create mode 100644 public/en.search-data.min.f76214aeb45811c3dbe8028a1b8eee01fc2658169071c7c5396da9c179eacce6.json
 create mode 100644 public/en.search-data.min.f79486bd15a55d330b1fa3f4ef0a360fa5c542d31a568fec5b62db13d327a41a.json
 create mode 100644 public/en.search-data.min.f9db45a23cb4497e8bc2c2f600250beb94d650a0523c2e7b87477e512bf4dfa3.json
 create mode 100644 public/en.search-data.min.fa11f048f1b592c754cab90f1404f8f79d243ac5b152e6a7c6e996a672b104ea.json
 create mode 100644 public/en.search-data.min.fdf83f427e5e85cf54a6b147dbcf542a22b238521d962dcbec69aae302f03f06.json
 create mode 100644 public/en.search-data.min.fe0941d300a2370fc90ac6edc4c194ea7c53bf16dc26d1a4463f8e32d18a9818.json
 create mode 100644 public/en.search-data.min.fefbbafff9709c04c0513eb160c0dcf2613bb13447e9dc11b095c6e4f9b9674c.json
 create mode 100644 public/en.search.min.0629cc2dcd1514be91a03b7c4d2fffdb5543bf29094bb2063c392f0ae60a14e4.js
 create mode 100644 public/en.search.min.0aca526e065b9eb8ea0de32118f4bfdd95a1cdcb5192c60385bba27b4c4eda08.js
 create mode 100644 public/en.search.min.104744330f9e84d2e0c6180293dd1d823cdeeb343dee9cea738e069dfb565420.js
 create mode 100644 public/en.search.min.10567831423c19baa1a8e4ee806278124e30d4897a96aaf7fff17f8e4852983c.js
 create mode 100644 public/en.search.min.1062e4728e1a75483bd4f9e11807cd2a5141fe0c0f945e9024402d1664f48d2f.js
 create mode 100644 public/en.search.min.1cc3252b5b149dbe2cda0ef14b7ff7609b47c457f094d2c89b291011b56bcc9a.js
 create mode 100644 public/en.search.min.1e1860c723036faf16afd0faf0b5f4f039969fd0b90323b2ebddf57225724333.js
 create mode 100644 public/en.search.min.1e8c11fb3f421d9bb0be55a206a64c24b669773267605536157269c618f7453b.js
 create mode 100644 public/en.search.min.21dbb425d5122f534606d6480caff7ec2e5a14017891ef9bd5bc181e9066c225.js
 create mode 100644 public/en.search.min.2371012a26f7d7de5940d6856beead7a057040968768aebe96199b2bbad09452.js
 create mode 100644 public/en.search.min.2429b6cf960d4bd768a8e3de75bd15a3cd2c52ff5c8926e72522560dc018e655.js
 create mode 100644 public/en.search.min.245096908ebf862a16d9bd22cba628242011cd4f0bb566e5a815cf05422825a7.js
 create mode 100644 public/en.search.min.24524669a41d2dfde47a5abe42ebdd94480d0f428cc116e95050f66353746858.js
 create mode 100644 public/en.search.min.24ef9fafae4cf9e4f1ceca358b3072f0892f80671d367823439c4966b256043b.js
 create mode 100644 public/en.search.min.25eff2342e67788647ad9e58f55abba0661bc31801cdf0a3bcd7c9a0b4597d8d.js
 create mode 100644 public/en.search.min.25f8523e3174437056d210138542ea69842ea176dd4cd781e8a285fb3d02a395.js
 create mode 100644 public/en.search.min.26878aa7b55750513c9fcaa7bdaccc59c0259a399214a9a09cee7d46b538b6f7.js
 create mode 100644 public/en.search.min.29a385c6d15d1a4bebdc4a722519a155c5e313bff9e09b81653e2578d86ed2f7.js
 create mode 100644 public/en.search.min.29ee4a27c88fbddb01bb83c8ea71080a604c3a98346e6dfc66569ee1c4f32c39.js
 create mode 100644 public/en.search.min.2cf3e378c7fd5dbe2e2e6224e818730dbff89454657291bbd4859d0cef48a675.js
 create mode 100644 public/en.search.min.2fa4a401beb2d9954e2cabb23c808621efe5340455500c9ebfc626dfc04db1a2.js
 create mode 100644 public/en.search.min.2fd0f573bd555cdf637740e915465ab9f06016cbf9762057bde7edc0a9bb7c60.js
 create mode 100644 public/en.search.min.30678426dcf6de9bec6051babfc2c54801fc5c1b7670b484092f53107d91604e.js
 create mode 100644 public/en.search.min.32a0822dc4f6f1e43e47d203f8799dd8dfa5898079ad36749210a42f02f4a7e8.js
 create mode 100644 public/en.search.min.34c29ee7bc1bcaf25418aceaf0bd6a65272b631286bac32c67813ecf885535c4.js
 create mode 100644 public/en.search.min.35133240a2a23502c91831feb921a4f14d40cac0f1cab35a097fb4c482db014c.js
 create mode 100644 public/en.search.min.35195d735b20c4cc246dcc4aff29f586b03b084abb4003ec6c9cc021c9373f96.js
 create mode 100644 public/en.search.min.3625be2b7eae2b165390d9cf880b44dff6bf8d4d4be3b52807b1cea128f3cbc6.js
 create mode 100644 public/en.search.min.3701d715b592d7aa57362efee450af92be3f67098cd7816501294df2c1febcd6.js
 create mode 100644 public/en.search.min.39b026411c3003fe2ad92344565b07b35235da22347991e2d72babf2a7967e10.js
 create mode 100644 public/en.search.min.3d638e66b0ade41ca1778a84488fd1a9043a56bf45cce7f24d2b764d50bde2b4.js
 create mode 100644 public/en.search.min.3f74ebae5a8ad825e16a831044d31830f1a2f8af45f5ad3575bc308e0c34101f.js
 create mode 100644 public/en.search.min.42c6790b11812540700bfb31070f7ba65e601ecf3bb4c0ba79047e131e23229f.js
 create mode 100644 public/en.search.min.42d0dec470275f02bd5f985fc7704f83da24103420d740cb9f5a6e9d8aba8096.js
 create mode 100644 public/en.search.min.4ac818d2214351a8277578cd4141d3c4882a2feaa1e6fb9fd3fd2c94f6909be6.js
 create mode 100644 public/en.search.min.4b9e6c6e09dbf9ce31d7e15fdbaefc1ef5ec01820d83545856e978bf6990ccd5.js
 create mode 100644 public/en.search.min.4e781a2be7fbc92bbe661c4b74b4af771e3f10d20e7f925c0a90144aae3286ab.js
 create mode 100644 public/en.search.min.50749d0e87bc3db3d9bed7f7bd70360564c25e601408f37b2c081ed8d130e6a0.js
 create mode 100644 public/en.search.min.519b693064633daac2b47f2ec0e1dbb50db83e761951a087dcdbd34d0738f972.js
 create mode 100644 public/en.search.min.51af095858030583ba7bd4bc15e0588b0193d6424b023b9b3acb783c2942e482.js
 create mode 100644 public/en.search.min.569256f40a6f265b3376bc11b3e1d0f4b3079033d393d26f1014aa088d14ecfd.js
 create mode 100644 public/en.search.min.586a1f75221903bf95df40855804f43cf5f0751e176764c8d928ee4ee6a11222.js
 create mode 100644 public/en.search.min.5aa9e207f1d42fcaf6b59c1fe02e761680a0c04d8daa601872c0a9fe8a41b75e.js
 create mode 100644 public/en.search.min.5bbc5009ed6363986b719f06ede6f10345bb6400da4523f2f50f4a78c8fda23e.js
 create mode 100644 public/en.search.min.5d17048555b1e724af5f10053539cffc60aee2f3bea99073ad08de237cdb81b1.js
 create mode 100644 public/en.search.min.5df65206c3fc0eba37f11cf29d689e638d5613f66dfbf82b8e01dd9bf95ce0c9.js
 create mode 100644 public/en.search.min.5e3e547885ed92aeee216bdfba6f3612bdc1bd2f54feec3db391737928f883d9.js
 create mode 100644 public/en.search.min.61c5ce8c96b8a378938f2a2946eccfaae40974310da2bf908c7f17ac7ef11b56.js
 create mode 100644 public/en.search.min.64df3165902afcd7f139c6dbe1089cdba2c5a05d14b42f9665824f7b14a1f3ee.js
 create mode 100644 public/en.search.min.64e5198ac3375920bf55827b8170a773ce8b315b33d2f999b87683cd3b1f2bee.js
 create mode 100644 public/en.search.min.689ddd09ea7fc1639fdee6d8af090f6671abbdd8adeff0d10961f061c7830ba6.js
 create mode 100644 public/en.search.min.68e376b3c5bafe5ac0021cf4ea2fce2ea6ae432df6586c39f084478daa5aa909.js
 create mode 100644 public/en.search.min.6c4af490195bc3fdeb7111d74cd9c9156314dd66f85c326cdca7f5e2b8e03a6d.js
 create mode 100644 public/en.search.min.7082a8a31f3629e294787152eaec94d9a5633bd820911b19d773a9a8539a5d08.js
 create mode 100644 public/en.search.min.70d59b80a0b2f6b7e1a3668238c7c09509b2dc4ab233f2e04ef4fb96aa750a96.js
 create mode 100644 public/en.search.min.70f85acc26307da1615fc02473fca459fdea2aaa77433af476d7e9f302b585c2.js
 create mode 100644 public/en.search.min.7484aa47672acf4203a554b424a42d89507df038af1cb51ecb40c716a5e8df04.js
 create mode 100644 public/en.search.min.755b2c4577f15fbc07ef07347d3b3144c73bbf89c489d36b8df36b82eb3647f3.js
 create mode 100644 public/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js
 create mode 100644 public/en.search.min.77cebe39b7952ba196a61987eabf00157d46f75471ef303fd1f3d327c0071c1f.js
 create mode 100644 public/en.search.min.78219bfc481daf5b357956a7eb4e195236f9540d03ad70187a7adbffb60b43c8.js
 create mode 100644 public/en.search.min.7951d01125f67427fa6732008921c6f26a53d45254eaf1e43afa9b5466466002.js
 create mode 100644 public/en.search.min.7b4568ecfa9b6172129f87a00fee4bb35bbe734e09d62a0edbfdb642c565b277.js
 create mode 100644 public/en.search.min.7c94624103b8e8bec52f50ad70b35a1d88c73934c5dac57c428daa5f7174958e.js
 create mode 100644 public/en.search.min.7dc2dd67285cfc04a59bb94520a7190e16bde7ee2010137ee171941ab301c492.js
 create mode 100644 public/en.search.min.7f0ba8a936636c7e80ccebdfee478f9f69409943b54831d0b1ae7e72ae91c57c.js
 create mode 100644 public/en.search.min.7f16c1879d39c99a913184608e1729dbaddc2478196ced444a82bdc2a2fd514c.js
 create mode 100644 public/en.search.min.808c49a68509b33a4893e1e7e2dac1a844d1df6b692a21aff7a18690f8e17fb0.js
 create mode 100644 public/en.search.min.80eb5454a2e5ca2bced97589678076987ac33781454a3a12b20e65add02060b9.js
 create mode 100644 public/en.search.min.824769706f1cb7fe17475bf066534006297513d7d5b54e210d446f99988746ee.js
 create mode 100644 public/en.search.min.82626a305de4128c9668eeb061c1472b4662bd51e976ece4ee72a21a5b304d7f.js
 create mode 100644 public/en.search.min.8267a5d7dc5224a1e37671902ac909535d5a122007d77322998062e5e6244341.js
 create mode 100644 public/en.search.min.8351b5cf290f8354b2acb5458f4ea8ec9bdcc0fc15835306aea04a833476d220.js
 create mode 100644 public/en.search.min.869b80bd1897e92c829bb12587a6ffc62a6da2669464b4b5c56f8772e36caed5.js
 create mode 100644 public/en.search.min.89098bbaa3295c079f7971528665b54616525599eeb7ee852fb5a9f74b13293d.js
 create mode 100644 public/en.search.min.8c2609c5dcc885f793f4d2e82584163518fb1c21fa2d48342aac34580ad01e05.js
 create mode 100644 public/en.search.min.8d0a132a99798b8691c357719af3b3a275bb8c60d8c350cb7c12b6403bc6d8a6.js
 create mode 100644 public/en.search.min.8e6b6a1f9ae0bcc6f96160ef636cee53154df37bc76d8e81ed30cbb48bd8fa14.js
 create mode 100644 public/en.search.min.8f32e5112d9987b318c16bbdbd9f3f59c754d7695362548a32efd243004febb5.js
 create mode 100644 public/en.search.min.92c9a8c3b59827823cb02512ec4ea025f3b312748488a529da3a6f3e3ea88a09.js
 create mode 100644 public/en.search.min.94107bc47e08b24d9a4a6ceab8e3e2f3c59ad14dc6459778888f766fd029a8e8.js
 create mode 100644 public/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js
 create mode 100644 public/en.search.min.97925bef4fbbc0d56e68073475805f804ff0db6941b67d0a4097ade2ce57d595.js
 create mode 100644 public/en.search.min.99afd73ef8b8f2e8c49bd47fa70c316bb594e105fabecd7fd3a441ce7174be3e.js
 create mode 100644 public/en.search.min.99ed48400dde8fe37801b70d20f235738fe068f2586726719253ddb97354742c.js
 create mode 100644 public/en.search.min.9c0d67c37d7ab5a44ca291865accd872d300ce864e9b55b1324f1f6adc725ddf.js
 create mode 100644 public/en.search.min.9cbedddc2541fc0cedcabce21e6a94e85e2698b04566e231ef5d91d6cd8c1011.js
 create mode 100644 public/en.search.min.9db4ddedcc9ac99b93862fe601a7eab54221e49f7326291bc8463880ce04c519.js
 create mode 100644 public/en.search.min.a16e783d72e3615fe1f27052217b56c087f61a5f2df018e7f36c72280ce25b73.js
 create mode 100644 public/en.search.min.a48047ea0271f766b04e88802243bb2965f6b1b1111af1adc118e5de853b9d45.js
 create mode 100644 public/en.search.min.a496ffe34d054960d0c8122994ee30236ad01aa8bc80a1d270c30f34f0c02575.js
 create mode 100644 public/en.search.min.a5d7cec1e9459342629ea16c410e23dfda0b26e6804a64931ff6365698678411.js
 create mode 100644 public/en.search.min.aa3780aa295cb80b2b4d886afb2b094ef8298e67bc982a98497133eee20eff0d.js
 create mode 100644 public/en.search.min.ab94619d4e5ba35ac9d0b3acfec0d681ee7a1ef36cc383559e3ec9721feef328.js
 create mode 100644 public/en.search.min.ae2f01b3fbdb48b1b74fe64553d1e9b7a99959e51a535976b633c858f9fb5ce0.js
 create mode 100644 public/en.search.min.ae45270e7aba08d7d38ad204ea92a05a378ad5c114f8eae6c5402b22bc14dfb5.js
 create mode 100644 public/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js
 create mode 100644 public/en.search.min.b0b6bbf515b5fa343ec49d730ec6980f79e4bb567b5c54f9c4b20ceb722e70c9.js
 create mode 100644 public/en.search.min.b499a172a035273577e04d29d7214fd2e2ca8f8291c60b35c9378d5a1b429005.js
 create mode 100644 public/en.search.min.b77799106eab9f2b103e5788a8d7e10518349da630e042bd591e6403d1febfe8.js
 create mode 100644 public/en.search.min.b8573861646135a8fbed93dddfaa6309b473c03ab2f9aac665d2a1a661a400bc.js
 create mode 100644 public/en.search.min.b8f69ae3247a43bdf7c17b8ce3b719cdc738265dedc0378886b313fd97712378.js
 create mode 100644 public/en.search.min.b9e2e62d90449c748c360995f89a81b2a0fda9294d30d1a3f231355c31d2195b.js
 create mode 100644 public/en.search.min.ba037690b2aae1c34b8d6879ae08787d7e70aea6379e4b99a1ff9bed0a35412a.js
 create mode 100644 public/en.search.min.bc8a730c38778da6dd3c795c63c78f44391ac404d640e3016fae9ac51593b4cb.js
 create mode 100644 public/en.search.min.bdeca18d14b9171f760675456af5b0f992080deadf61103473ddc717f34310d1.js
 create mode 100644 public/en.search.min.c13a16ae805c817d5bb47b5e2484085f8a309d0b846234937e58fdb7c6070b2f.js
 create mode 100644 public/en.search.min.c36b0af8d46c12500c018e4f975ab5780930ee1fd43c4f84ec507446218d4752.js
 create mode 100644 public/en.search.min.c37dee990b604bcf09bf2b1ac7b3d359663e9e1b0be153d0c337a02f6bdd3423.js
 create mode 100644 public/en.search.min.c52da93774ced0b779087bc46b608b93aa09fc490e972f1da53c931c95275982.js
 create mode 100644 public/en.search.min.d40d3e3d76eff60f795b62063fce4b8f5fa50bfde284a37673f3197b4946da4a.js
 create mode 100644 public/en.search.min.d48a86e8604c49f62d363fab3d0bc4b0279ab8b77869962c31524132c3e6656a.js
 create mode 100644 public/en.search.min.d711d7f6df0def3edacc84bbc37235fc85d6108172076e79c3f40457143e3e18.js
 create mode 100644 public/en.search.min.d9c46255f8596968a96aa9ca7d0f29f2900440db29a7eeb4715dd2dc057e8213.js
 create mode 100644 public/en.search.min.dc4a3704c29eed52558a674d00acd6704d7ec37b088c744fff93db2ce6371e50.js
 create mode 100644 public/en.search.min.dd7585aa780207ec28b8c9eb7353b201943637284711d56d0c86d7b640b1cbb1.js
 create mode 100644 public/en.search.min.de13c7a03a82e1e1c3e3b691a04fd17421cae63011231a8a1f61e6864e703c21.js
 create mode 100644 public/en.search.min.df0eed5f0236d46ff083eb83a00462f5d3f36020a3b154d9a9f5dd703e219689.js
 create mode 100644 public/en.search.min.df3d77169b328722c21fb2f931d7494bb15a9f538a6bf4ab1d88f83b8c2c9570.js
 create mode 100644 public/en.search.min.df6106ea2264133050e37ea1e4b59e6d94c58713631c02368af511452b8138f0.js
 create mode 100644 public/en.search.min.e0fc51a7042a1fe031162f71d818ec60751c4576b1a88219906c722bd527d9cc.js
 create mode 100644 public/en.search.min.e1452005bf529ada3f821e8b5bd588e6ee798c61af840b239f70fd17a926a1f4.js
 create mode 100644 public/en.search.min.e3b4a63229fceb760e86ab1b412f43ff34c01a547f0276a0d8efd431c62bcb2b.js
 create mode 100644 public/en.search.min.e56c3fa5faa3782d354a13ac3c75eaff32e28b0e62306ab2969b25d6bc2947eb.js
 create mode 100644 public/en.search.min.e84cd68997bc541860a11a9ebcd8369a884cca99874a976ffc2546f5a6ccfbe6.js
 create mode 100644 public/en.search.min.e925ade840e4ad5ac5b6376d696b85b9950aa292222a1e0b0a17a6662af7fcc2.js
 create mode 100644 public/en.search.min.ed0ee1494386afa2c9e0689a3c39ba4de6ae0a0bbbf05774e992bf66b5bf7eec.js
 create mode 100644 public/en.search.min.ed4281223476397821bb0f574a22254cb0af857a6c6f5f018e516b51695dd3c2.js
 create mode 100644 public/en.search.min.eebe38aea2e9eceb99d28da6711f23889abdfadfd2d78cc10939dd22a6a600a2.js
 create mode 100644 public/en.search.min.ef4488c076173b86dfff563b59eab35046f2c32fa2ba08243c8514a6eaa81971.js
 create mode 100644 public/en.search.min.f17a2a15ff389d4fdc309bce9c690659208cfbfebf8e126b0d47da5b75a3a51a.js
 create mode 100644 public/en.search.min.f1f53372db5fc03c6b6f44fa692ec6f07e64e7ffe8cf110d0ef2534d34bf6588.js
 create mode 100644 public/en.search.min.f3eea2569cbf5e2aa67f7cfd6de6cf16e6f7fe3bd02b10fe50336c55bd7d9fda.js
 create mode 100644 public/en.search.min.f5465f54a0d6221a804f254eb4965c17c87da4f70fce2fc2d3cf1e18f79746d1.js
 create mode 100644 public/en.search.min.f620aa03fcc371afd0dbc92f970778e35bdb78b63d6e33ef78f855421f02d488.js
 create mode 100644 public/en.search.min.f7411bf3499b1f63054e525228187a98b4c0fce65f494c509b9362b9b63cec41.js
 create mode 100644 public/en.search.min.f75b6a32a0c3c800434e9600384e985703714fc2cbb88b0735f74be242503441.js
 create mode 100644 public/en.search.min.f8aa4609e39892a78bc3e544207a5859147f7696a6b284f39d0b6a495de75325.js
 create mode 100644 public/en.search.min.fe257477d333f8d11bfe167e9e67d3faf22765ee8a95d9505966667280c32d12.js
 create mode 100644 public/en.search.min.fee1c1313db92862c01d1c31742437564a0901773bbe502e4e3a31d21b2a35ee.js

diff --git a/assets/_custom.scss b/assets/_custom.scss
index fd71029..ce0df69 100644
--- a/assets/_custom.scss
+++ b/assets/_custom.scss
@@ -60,6 +60,63 @@ h2, h3 {
     text-decoration-color: #FF6700;
     text-decoration-thickness: 3px;
 }
+
 .fab {
-    font-family: 'IBMPlexMono', sans-serif;
+    font-family: 'IBMPlexMono', monospace;
+}
+
+.ref-header {
+    font-family: 'IBMPlexMono', monospace;
+    color: black;
+    font-size: 2em;
+    text-decoration: none;
+}
+
+.ref-item {
+    font-family: 'IBMPlexMono', monospace;
+    color: black;
+    font-size: 1em;
+}
+.ref-info {
+    font-family: 'Inter', sans-serif;
+    color: black;
+    font-size: 0.9em;
+}
+
+// Overwrite some of the Hugo Book theme styles
+.markdown a {
+    color:black;
+}
+
+.markdown a:visited{
+    color:black;
+}
+
+.markdown a:hover {
+    background-color: #FF6700;
+}
+
+td {
+    width: 30%;
+    vertical-align: top;
+}
+
+.markdown table tr td {
+    padding: 1rem 4rem 4rem 0rem;
+    border: none;
+}
+
+.markdown table tr:nth-child(2n) {
+    background: white;
+}
+
+.grid-container {
+    display: grid;
+    grid-template-columns: 20% 80%;
+    gap: 0.75rem 0;
+  }
+
+.grid-item {
+    height: auto;
 }
+
diff --git a/content/docs/reference.md b/content/docs/reference.md
deleted file mode 100644
index 15257c6..0000000
--- a/content/docs/reference.md
+++ /dev/null
@@ -1,230 +0,0 @@
-# Reference
-
-
-## Fab
-A class to describe a fabrication machine.
-
-A `fab` object represents a 3D printer. It is comprised of the following information:
-- `workEnvelope`: maximum X, Y, and Z dimensions of the machine
-- `nozzleDiameter`: Diameter of the nozzle in mm
-- `filamentDiameter`: Diameter of filament in mm
-- `name`: a human readable string to identify this machine
-
-### Syntax
-```fab([config])```
-
-### Parameters
-- config: a json object specifying requisite machine information
-
----
-
-## autoHome
-Autohome the machine (with a `G28` command) and zero the extruder position (with a `G92 E0` command). 
-
-### Syntax
-```fab.autoHome()```
-
-### Parameters
-None
-
----
-
-## setNozzleT
-Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.
-
-Most firmware won't wait for temperatures less than 40C since they will never be reached due to ambient temperature.
-
-### Syntax
-```fab.setNozzleT(temperature, [wait])```
-
-### Parameters
-- temperature: Number, the temperature to heat the nozzle to in degrees Celcius
-- wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.
-
----
-
-## setBedT
-Set the printer's bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.
-
-Most firmware won't wait for temperatures less than 40C since they will never be reached due to ambient temperature.
-
-### Syntax
-```fab.setNozzleT(temperature, [wait])```
-
-### Parameters
-- temperature: Number, the temperature to heat the bed to in degrees Celcius
-- wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.
-
----
-
-## setTemps
-Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.
-
-Most firmware won't wait for temperatures less than 40C since they will never be reached due to ambient temperature.
-
-### Syntax
-```fab.setTemps(nozzleTemperature, bedTemperature, [wait])```
-
-### Parameters
-- nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius
-- bedTemperature: Number, the temperature to heat the bed to in degrees Celcius
-- wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.
-
----
-
-## moveTo
-Move directly to an absolute (x,y,z) position without extruding material.
-
-### Syntax
-```fab.moveTo(x, y, z, [velocity])```
-
-### Parameters
-- x: Number, the x position to move to (in current units, mm by default)
-- y: Number, the y position to move to (in current units, mm by default)
-- z: Number, the z position to move to (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveToX
-Move directly to an absolute X position without extruding material.
-
-### Syntax
-```fab.moveToX(x, [velocity])```
-
-### Parameters
-- x: Number, the x position to move to (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveToY
-Move directly to an absolute Y position without extruding material.
-
-### Syntax
-```fab.moveToY(y, [velocity])```
-
-### Parameters
-- y: Number, the y position to move to (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveToZ
-Move directly to an absolute Z position without extruding material.
-
-### Syntax
-```fab.moveToZ(z, [velocity])```
-
-### Parameters
-- z: Number, the z position to move to (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveToE
-Move directly to an absolute E position.
-
-### Syntax
-```fab.moveToE(e, [velocity])```
-
-### Parameters
-- e: Number, the e position to move to (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## move
-Move relative to the current position without extruding material.
-
-### Syntax
-```fab.move(dx, dy, dz, [velocity])```
-
-### Parameters
-- dx: Number, the relative x distance to move (in current units, mm by default)
-- dy: Number, the relative y distance to move (in current units, mm by default)
-- dz: Number, the relative z distance to move (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveX
-Move in X relative to the current position without extruding material.
-
-### Syntax
-```fab.moveX(dx, [velocity])```
-
-### Parameters
-- dx: Number, the relative x distance to move (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
-- dx: Number, the relative x distance to move (in current units, mm by default)
-
-## moveY
-Move in Y relative to the current position without extruding material.
-
-### Syntax
-```fab.moveY(dy, [velocity])```
-
-### Parameters
-- dy: Number, the relative y distance to move (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveZ
-Move in Z relative to the current position without extruding material.
-
-### Syntax
-```fab.moveZ(dz, [velocity])```
-
-### Parameters
-- dz: Number, the relative z distance to move (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveE
-Move in E relative to the current position.
-
-### Syntax
-```fab.moveE(de, [velocity])```
-
-### Parameters
-- de: Number, the relative e distance to move (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## travelTo
-Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.
-
-The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.
-
-### Syntax
-```fab.travelTo(x, y, z, [velocity])```
-
-### Parameters
-- x: Number, the x position to move to (in current units, mm by default)
-- y: Number, the y position to move to (in current units, mm by default)
-- z: Number, the z position to move to (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-
----
-
-## moveExtrude
-Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.
-
-### Syntax
-```fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])```
-
-### Parameters
-- x: Number, the x position to move to (in current units, mm by default)
-- y: Number, the y position to move to (in current units, mm by default)
-- z: Number, the z position to move to (in current units, mm by default)
-- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
-- extrusion:  Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter
-- multiplication: Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default.
-
----
-
diff --git a/content/docs/reference/_index.md b/content/docs/reference/_index.md
new file mode 100644
index 0000000..7d0f3ec
--- /dev/null
+++ b/content/docs/reference/_index.md
@@ -0,0 +1,124 @@
+# Reference
+
+## <a href="reference-pages/fab">Fab</a>
+<!-- template for adding new doc items  -->
+<!--
+<tr>
+    <td>
+
+    </td>
+    <td>
+    
+    </td>
+    <td>
+    
+    </td>
+</tr>
+-->
+
+### Path Commands
+
+<table>
+  <tbody>
+    <tr>
+      <td>
+        <a href="reference-pages/moveTo" class="ref-item">moveTo()</a><br>
+        <span class="ref-info">Move to a point.</span>  
+      </td>
+      <td>
+        <a href="reference-pages/moveToX" class="ref-item">moveToX()</a><br>
+        <span class="ref-info">Move to an X position.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveToY" class="ref-item">moveToY()</a><br>
+        <span class="ref-info">Move to a Y position.</span>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a href="reference-pages/moveToZ" class="ref-item">moveToZ()</a><br>
+        <span class="ref-info">Move to a Z position.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveToE" class="ref-item">moveToE()</a><br>
+        <span class="ref-info">Move to a E position.</span> 
+      </td>
+      <td>
+        <a href="reference-pages/move" class="ref-item">move()</a><br>
+        <span class="ref-info">Move relative to current position in x, y, and z.</span>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a href="reference-pages/moveX" class="ref-item">moveX()</a><br>
+        <span class="ref-info">Move relative to current position in X.</span></td>
+      <td>
+        <a href="reference-pages/moveY" class="ref-item">moveY()</a><br>
+        <span class="ref-info">Move relative to current position in Y.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveZ" class="ref-item">moveZ()</a><br>
+        <span class="ref-info">Move relative to current position in Z.</span>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a href="reference-pages/moveE" class="ref-item">moveE()</a><br>
+        <span class="ref-info">Move relative to current position in E.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveExtrude" class="ref-item">moveExtrude()</a><br>
+        <span class="ref-info">Move to an x,y,z position while extruding.</span>        
+      </td>
+      <td>
+        <a href="reference-pages/travelTo" class="ref-item">travelTo()</a><br>
+        <span class="ref-info">Move to an x,y,z position with a z-hop.</span>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+### G & M Codes
+
+<table>
+  <tbody>
+    <tr>
+        <td>
+            <a href="reference-pages/autohome" class="ref-item">autoHome()</a><br>
+            <span class="ref-info">Autohome the machine.</span>
+        </td>
+        <td>
+            <a href="reference-pages/setBedT" class="ref-item">setBedT()</a><br>
+            <span class="ref-info">Set bed temperature.</span>
+        </td>
+        <td>
+            <a href="reference-pages/setNozzleT" class="ref-item">setNozzleT()</a><br>
+            <span class="ref-info">Set nozzle temperature.</span>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            <a href="reference-pages/setTemps" class="ref-item">setTemps()</a><br>
+            <span class="ref-info">Set nozzle & bed temperatures.</span>
+        </td>
+        <td>
+          <a href="reference-pages/setAbsolutePosition" class="ref-item">setAbsolutePosition()</a><br>
+          <span class="ref-info">Use absolute coordinates.</span>
+        </td>
+        <td>
+          <a href="reference-pages/setAbsolutePositionXYZ" class="ref-item">setAbsolutePositionXYZ()</a><br>
+          <span class="ref-info">Use absolute coordinates for dimensional axes.</span>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            <a href="reference-pages/setEAbsolute" class="ref-item">setEAbsolute()</a><br>
+            <span class="ref-info">Use absolute coordinates for extruder position.</span>
+        </td>
+        <td>
+          <a href="reference-pages/setERelative" class="ref-item">setERelative()</a><br>
+            <span class="ref-info">Use relative coordinates for extruder position.</span>
+        </td>
+    </tr>
+  </tbody>
+</table>
diff --git a/content/docs/reference/reference-pages/autohome.md b/content/docs/reference/reference-pages/autohome.md
new file mode 100644
index 0000000..ce5ce46
--- /dev/null
+++ b/content/docs/reference/reference-pages/autohome.md
@@ -0,0 +1,15 @@
+---
+title: "Autohome"
+bookHidden: true
+---
+
+<h2 class="ref-header">autoHome()</h2>
+Autohome the machine (with a <code>G28</code> command) and zero the extruder position (with a <code>G92 E0</code> command). 
+
+## Syntax
+```
+fab.autoHome()
+```
+
+## Parameters
+None
diff --git a/content/docs/reference/reference-pages/fab.md b/content/docs/reference/reference-pages/fab.md
new file mode 100644
index 0000000..a276de2
--- /dev/null
+++ b/content/docs/reference/reference-pages/fab.md
@@ -0,0 +1,19 @@
+---
+title: "Fab"
+bookHidden: true
+---
+
+## Fab
+A class to describe a fabrication machine.
+
+A `fab` object represents a 3D printer. It is comprised of the following information:
+- `workEnvelope`: maximum X, Y, and Z dimensions of the machine
+- `nozzleDiameter`: Diameter of the nozzle in mm
+- `filamentDiameter`: Diameter of filament in mm
+- `name`: a human readable string to identify this machine
+
+### Syntax
+```fab([config])```
+
+### Parameters
+- config: a json object specifying requisite machine information
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/move.md b/content/docs/reference/reference-pages/move.md
new file mode 100644
index 0000000..c03e88b
--- /dev/null
+++ b/content/docs/reference/reference-pages/move.md
@@ -0,0 +1,27 @@
+---
+title: "Move"
+bookHidden: true
+---
+
+<h2 class="ref-header">move()</h2>
+Move relative to the current position without extruding material.
+
+### Syntax
+```
+fab.move(dx, dy, dz, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">dx</div>
+ <div class="grid-item">Number, the relative x distance to move (in current units, mm by default)</div>
+
+ <div class="grid-item">dy</div>
+ <div class="grid-item">Number, the relative y distance to move (in current units, mm by default)</div>
+
+ <div class="grid-item">dz</div>
+ <div class="grid-item">Number, the relative z distance to move (in current units, mm by default)</div>
+
+ <div class="grid-item">velocity</div>
+ <div class="grid-item">v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/moveE.md b/content/docs/reference/reference-pages/moveE.md
new file mode 100644
index 0000000..a942e89
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveE.md
@@ -0,0 +1,21 @@
+---
+title: "moveE"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveE()</h2>
+Move in E relative to the current position.
+
+### Syntax
+```
+fab.moveE(de, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">de</div>
+ <div class="grid-item">Number, the relative e distance to move (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
diff --git a/content/docs/reference/reference-pages/moveExtrude.md b/content/docs/reference/reference-pages/moveExtrude.md
new file mode 100644
index 0000000..04b39be
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveExtrude.md
@@ -0,0 +1,33 @@
+---
+title: "Move Extrude"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveExtrude()</h2>
+Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.
+
+### Syntax
+```
+fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">y</div>
+ <div class="grid-item">Number, the y position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+
+<div class="grid-item">extrusion</div>
+ <div class="grid-item">Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter</div>
+
+<div class="grid-item">multiplication</div>
+ <div class="grid-item">Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default.</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/moveTo.md b/content/docs/reference/reference-pages/moveTo.md
new file mode 100644
index 0000000..79a8d35
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveTo.md
@@ -0,0 +1,27 @@
+---
+title: "Move To"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveTo()</h2>
+Move directly to an absolute (x,y,z) position without extruding material.
+
+### Syntax
+```
+fab.moveTo(x, y, z, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">y</div>
+ <div class="grid-item">y: Number, the y position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/moveToE.md b/content/docs/reference/reference-pages/moveToE.md
new file mode 100644
index 0000000..161dd1c
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveToE.md
@@ -0,0 +1,23 @@
+---
+title: "Move To E"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveToE()</h2>
+Move directly to an absolute E position.
+
+### Syntax
+```
+fab.moveToE(e, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">e</div>
+ <div class="grid-item">e: Number, the e position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
+- e: Number, the e position to move to (in current units, mm by default)
+- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/moveToX.md b/content/docs/reference/reference-pages/moveToX.md
new file mode 100644
index 0000000..83f7a37
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveToX.md
@@ -0,0 +1,21 @@
+---
+title: "Move To X"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveToX()</h2>
+Move directly to an absolute X position without extruding material.
+
+### Syntax
+```
+fab.moveToX(x, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
diff --git a/content/docs/reference/reference-pages/moveToY.md b/content/docs/reference/reference-pages/moveToY.md
new file mode 100644
index 0000000..b46e174
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveToY.md
@@ -0,0 +1,21 @@
+---
+title: "Move To Y"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveToY()</h2>
+Move directly to an absolute Y position without extruding material.
+
+### Syntax
+```
+fab.moveToY(y, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">y</div>
+ <div class="grid-item">Number, the y position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/moveToZ.md b/content/docs/reference/reference-pages/moveToZ.md
new file mode 100644
index 0000000..1cba3c7
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveToZ.md
@@ -0,0 +1,21 @@
+---
+title: "MoveToZ"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveToZ()</h2>
+Move directly to an absolute Z position without extruding material.
+
+### Syntax
+```
+fab.moveToZ(z, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/moveX.md b/content/docs/reference/reference-pages/moveX.md
new file mode 100644
index 0000000..d4f023d
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveX.md
@@ -0,0 +1,21 @@
+---
+title: "Move To X"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveX()</h2>
+Move in X relative to the current position without extruding material.
+
+### Syntax
+```
+fab.moveX(dx, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">dx</div>
+ <div class="grid-item">Number, the relative x distance to move (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/moveY.md b/content/docs/reference/reference-pages/moveY.md
new file mode 100644
index 0000000..24b88be
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveY.md
@@ -0,0 +1,21 @@
+---
+title: "Move Y"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveY()</h2>
+Move in Y relative to the current position without extruding material.
+
+### Syntax
+```
+fab.moveY(dy, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">dy</div>
+ <div class="grid-item">Number, the relative y distance to move (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
diff --git a/content/docs/reference/reference-pages/moveZ.md b/content/docs/reference/reference-pages/moveZ.md
new file mode 100644
index 0000000..c818460
--- /dev/null
+++ b/content/docs/reference/reference-pages/moveZ.md
@@ -0,0 +1,22 @@
+
+---
+title: "MoveZ"
+bookHidden: true
+---
+
+<h2 class="ref-header">moveZ()</h2>
+Move in Z relative to the current position without extruding material.
+
+### Syntax
+```
+fab.moveZ(dz, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">dz</div>
+ <div class="grid-item">Number, the relative z distance to move (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
diff --git a/content/docs/reference/reference-pages/setAbsolutePosition.md b/content/docs/reference/reference-pages/setAbsolutePosition.md
new file mode 100644
index 0000000..7b9ad1b
--- /dev/null
+++ b/content/docs/reference/reference-pages/setAbsolutePosition.md
@@ -0,0 +1,17 @@
+---
+title: "Set Absolute Position"
+bookHidden: true
+---
+
+<h2 class="ref-header">setAbsolutePosition()</h2>
+Set coordinates to absolute positioning, relative to the origin of the machine (using a <code>G90</code> command).
+
+Note that <code>G90</code> behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see <a href="../setAbsolutePositionXYZ" class="ref-item">setAbsolutePositionXYZ()</a>, <a href="../setRelativePositionXYZ" class="ref-item">setRelativePositionXYZ()</a>, <a href="../reference-pages/setEAbsolute" class="ref-item">setEAbsolute()</a>, & <a href="../reference-pages/setERelative" class="ref-item">setERelative()</a>.
+
+### Syntax
+```
+fab.setAbsolutePosition()
+```
+
+### Parameters
+None
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/setAbsolutePositionXYZ.md b/content/docs/reference/reference-pages/setAbsolutePositionXYZ.md
new file mode 100644
index 0000000..2b152fd
--- /dev/null
+++ b/content/docs/reference/reference-pages/setAbsolutePositionXYZ.md
@@ -0,0 +1,15 @@
+---
+title: "Set Absolute Position XYZ"
+bookHidden: true
+---
+
+<h2 class="ref-header">setAbsolutePositionXYZ()</h2>
+Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode.
+
+### Syntax
+```
+fab.setAbsolutePositionXYZ()
+```
+
+### Parameters
+None
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/setBedT.md b/content/docs/reference/reference-pages/setBedT.md
new file mode 100644
index 0000000..fe515f5
--- /dev/null
+++ b/content/docs/reference/reference-pages/setBedT.md
@@ -0,0 +1,23 @@
+---
+title: "Set Bed Temp"
+bookHidden: true
+---
+
+<h2 class="ref-header">setBedT()</h2>
+Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.
+
+Most firmware won't wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+
+### Syntax
+```
+fab.setBedT(temperature, [wait])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">temperature</div>
+ <div class="grid-item">Number, the temperature to heat the bed to in degrees Celcius</div>
+
+ <div class="grid-item">wait</div>
+ <div class="grid-item">Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default.</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/setEAbsolute.md b/content/docs/reference/reference-pages/setEAbsolute.md
new file mode 100644
index 0000000..83446c4
--- /dev/null
+++ b/content/docs/reference/reference-pages/setEAbsolute.md
@@ -0,0 +1,15 @@
+---
+title: "Set E Absolute"
+bookHidden: true
+---
+
+<h2 class="ref-header">setEAbsolute()</h2>
+Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode.
+
+### Syntax
+```
+fab.setEAbsolute()
+```
+
+### Parameters
+None
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/setERelative.md b/content/docs/reference/reference-pages/setERelative.md
new file mode 100644
index 0000000..ab22630
--- /dev/null
+++ b/content/docs/reference/reference-pages/setERelative.md
@@ -0,0 +1,15 @@
+---
+title: "Set E Relative"
+bookHidden: true
+---
+
+<h2 class="ref-header">setERelative()</h2>
+Set extruder axis to use relative position without changing the dimensional axes positioning mode.
+
+### Syntax
+```
+fab.setERelative()
+```
+
+### Parameters
+None
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/setNozzleT.md b/content/docs/reference/reference-pages/setNozzleT.md
new file mode 100644
index 0000000..5a7d48a
--- /dev/null
+++ b/content/docs/reference/reference-pages/setNozzleT.md
@@ -0,0 +1,23 @@
+---
+title: "Set Nozzle Temp"
+bookHidden: true
+---
+
+<h2 class="ref-header">setNozzleT()</h2>
+Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.
+
+Most firmware won't wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+
+### Syntax
+```
+fab.setNozzleT(temperature, [wait])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">temperature</div>
+ <div class="grid-item">Number, the temperature to heat the nozzle to in degrees Celcius</div>
+
+ <div class="grid-item">wait</div>
+ <div class="grid-item">Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default.</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/setTemps.md b/content/docs/reference/reference-pages/setTemps.md
new file mode 100644
index 0000000..a320fc6
--- /dev/null
+++ b/content/docs/reference/reference-pages/setTemps.md
@@ -0,0 +1,26 @@
+---
+title: "Set Temps"
+bookHidden: true
+---
+
+<h2 class="ref-header">setTemps()</h2>
+Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.
+
+Most firmware won't wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+
+### Syntax
+```
+fab.setTemps(nozzleTemperature, bedTemperature, [wait])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">nozzleTemperature</div>
+ <div class="grid-item">Number, the temperature to heat the nozzle to in degrees Celcius</div>
+
+ <div class="grid-item">bedTemperature</div>
+ <div class="grid-item">Number, the temperature to heat the bed to in degrees Celcius</div>
+
+ <div class="grid-item">wait</div>
+ <div class="grid-item">Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.</div>
+</div>
\ No newline at end of file
diff --git a/content/docs/reference/reference-pages/travelTo.md b/content/docs/reference/reference-pages/travelTo.md
new file mode 100644
index 0000000..0875679
--- /dev/null
+++ b/content/docs/reference/reference-pages/travelTo.md
@@ -0,0 +1,29 @@
+---
+title: "Travel To"
+bookHidden: true
+---
+
+<h2 class="ref-header">travelTo()</h2>
+Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.
+
+The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.
+
+### Syntax
+```
+fab.travelTo(x, y, z, [velocity])
+```
+
+### Parameters
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">y</div>
+ <div class="grid-item">y: Number, the y position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
diff --git a/content/docs/resources/guides/cc-intro.md b/content/docs/resources/guides/cc-intro.md
index ea33881..59a836c 100644
--- a/content/docs/resources/guides/cc-intro.md
+++ b/content/docs/resources/guides/cc-intro.md
@@ -1,6 +1,6 @@
 ---
 title: "A Gentle Introduction to Creative Coding with p5.js"
-weight: 2
+bookHidden: true
 ---
 
 ## A Gentle Introduction to Creative Coding with p5.js
diff --git a/content/docs/resources/guides/dfab-intro.md b/content/docs/resources/guides/dfab-intro.md
index 74e1f1c..68da8ac 100644
--- a/content/docs/resources/guides/dfab-intro.md
+++ b/content/docs/resources/guides/dfab-intro.md
@@ -1,6 +1,6 @@
 ---
 title: "A Gentle Introduction to Digital Fabrication"
-weight: 1
+bookHidden: true
 ---
 
 ## A Gentle Introduction to Digital Fabrication
diff --git a/content/docs/resources/guides/p5fab-primer.md b/content/docs/resources/guides/p5fab-primer.md
index 1ceb993..dc9f2c9 100644
--- a/content/docs/resources/guides/p5fab-primer.md
+++ b/content/docs/resources/guides/p5fab-primer.md
@@ -1,6 +1,6 @@
 ---
 title: "p5.fab Primer"
-weight: 2
+bookHidden: true
 ---
 
 ## <span class="fab">p5.fab</span> Primer
diff --git a/content/docs/resources/tutorials/cube-tutorial.md b/content/docs/resources/tutorials/cube-tutorial.md
index 8eea782..92faed6 100644
--- a/content/docs/resources/tutorials/cube-tutorial.md
+++ b/content/docs/resources/tutorials/cube-tutorial.md
@@ -1,6 +1,6 @@
 ---
 title: "Cube Tutorial"
-weight: 3
+bookHidden: true
 ---
 
 ## Printing a Cube
diff --git a/content/docs/resources/tutorials/line-vase-tutorial.md b/content/docs/resources/tutorials/line-vase-tutorial.md
index d7afc5f..d728eb7 100644
--- a/content/docs/resources/tutorials/line-vase-tutorial.md
+++ b/content/docs/resources/tutorials/line-vase-tutorial.md
@@ -1,6 +1,6 @@
 ---
 title: "Line Vase Tutorial"
-weight: 4
+bookHidden: true
 ---
 
 ## Line Vase Tutorial
diff --git a/content/docs/resources/tutorials/non-planar-tutorial.md b/content/docs/resources/tutorials/non-planar-tutorial.md
index 81163a1..6a2d856 100644
--- a/content/docs/resources/tutorials/non-planar-tutorial.md
+++ b/content/docs/resources/tutorials/non-planar-tutorial.md
@@ -1,6 +1,6 @@
 ---
 title: "Non-Planar Printing Tutorial"
-weight: 3
+bookHidden: true
 ---
 
 ## Line Vase Tutorial
diff --git a/public/404.html b/public/404.html
index c87bd38..74f4355 100644
--- a/public/404.html
+++ b/public/404.html
@@ -16,9 +16,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/404.html">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
diff --git a/public/book.min.0072748a3c9b86d83ee02c29dc6a14c878c80458c7d3a9738747c123a4aadf56.css b/public/book.min.0072748a3c9b86d83ee02c29dc6a14c878c80458c7d3a9738747c123a4aadf56.css
new file mode 100644
index 0000000..204e97f
--- /dev/null
+++ b/public/book.min.0072748a3c9b86d83ee02c29dc6a14c878c80458c7d3a9738747c123a4aadf56.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%;height:10%}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.00f308dff69f3e9b87ad0befdbcae2dfaa63039376cd11fa6146fcb8f19254b7.css b/public/book.min.00f308dff69f3e9b87ad0befdbcae2dfaa63039376cd11fa6146fcb8f19254b7.css
new file mode 100644
index 0000000..435b907
--- /dev/null
+++ b/public/book.min.00f308dff69f3e9b87ad0befdbcae2dfaa63039376cd11fa6146fcb8f19254b7.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:0 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.0233dfe37a3eae590cd2057b8ccdf95ea6927737137f4934b3c5210b9f5c1f83.css b/public/book.min.0233dfe37a3eae590cd2057b8ccdf95ea6927737137f4934b3c5210b9f5c1f83.css
new file mode 100644
index 0000000..2b4ccdf
--- /dev/null
+++ b/public/book.min.0233dfe37a3eae590cd2057b8ccdf95ea6927737137f4934b3c5210b9f5c1f83.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}.ref{font-family:ibmplexmono,sans-serif;text-decoration:none}
\ No newline at end of file
diff --git a/public/book.min.028072389c1d8c27b05c13d81f213e027289287344d4c842ad8288fcae3a33c0.css b/public/book.min.028072389c1d8c27b05c13d81f213e027289287344d4c842ad8288fcae3a33c0.css
new file mode 100644
index 0000000..7975792
--- /dev/null
+++ b/public/book.min.028072389c1d8c27b05c13d81f213e027289287344d4c842ad8288fcae3a33c0.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:0 5rem 2rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.03c75efe4b9229a2b35557b34300ef04367384144e4be93ae795aae7125a8cd4.css b/public/book.min.03c75efe4b9229a2b35557b34300ef04367384144e4be93ae795aae7125a8cd4.css
new file mode 100644
index 0000000..282f4bf
--- /dev/null
+++ b/public/book.min.03c75efe4b9229a2b35557b34300ef04367384144e4be93ae795aae7125a8cd4.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown tr{background:#fff}
\ No newline at end of file
diff --git a/public/book.min.04c76e5278fa305bb5cf9618e5ff076605273ff1728c17934411a2a02255c638.css b/public/book.min.04c76e5278fa305bb5cf9618e5ff076605273ff1728c17934411a2a02255c638.css
new file mode 100644
index 0000000..6615400
--- /dev/null
+++ b/public/book.min.04c76e5278fa305bb5cf9618e5ff076605273ff1728c17934411a2a02255c638.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:4rem 1.5rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.05e957753b405d5980f1f44467e3d64ad74fea8a4f755d12ad3fc922c31fa1ba.css b/public/book.min.05e957753b405d5980f1f44467e3d64ad74fea8a4f755d12ad3fc922c31fa1ba.css
new file mode 100644
index 0000000..4796685
--- /dev/null
+++ b/public/book.min.05e957753b405d5980f1f44467e3d64ad74fea8a4f755d12ad3fc922c31fa1ba.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}
\ No newline at end of file
diff --git a/public/book.min.06ae87669601e13856b80a5bebb33e745e295bb1e88e3582ad1cb410caf63e24.css b/public/book.min.06ae87669601e13856b80a5bebb33e745e295bb1e88e3582ad1cb410caf63e24.css
new file mode 100644
index 0000000..f7a483e
--- /dev/null
+++ b/public/book.min.06ae87669601e13856b80a5bebb33e745e295bb1e88e3582ad1cb410caf63e24.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}a:visited .ref-header{font-family:ibmplexmono,sans-serif;color:#000}.ref-item{font-family:ibmplexmono,sans-serif;color:#000}.ref-info{font-family:inter,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.0808bd7baf39a6d6fdae7cbf06a6f30705e58bd43123a27d6aa2cad3008f4d03.css b/public/book.min.0808bd7baf39a6d6fdae7cbf06a6f30705e58bd43123a27d6aa2cad3008f4d03.css
new file mode 100644
index 0000000..388374f
--- /dev/null
+++ b/public/book.min.0808bd7baf39a6d6fdae7cbf06a6f30705e58bd43123a27d6aa2cad3008f4d03.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}table{border:none}table tr th:empty{display:none}
\ No newline at end of file
diff --git a/public/book.min.0c8d7080bdb93407acb48e9efd8fc650050f3280290baf3890750bd07e82e22d.css b/public/book.min.0c8d7080bdb93407acb48e9efd8fc650050f3280290baf3890750bd07e82e22d.css
new file mode 100644
index 0000000..c1f41bf
--- /dev/null
+++ b/public/book.min.0c8d7080bdb93407acb48e9efd8fc650050f3280290baf3890750bd07e82e22d.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:1em}
\ No newline at end of file
diff --git a/public/book.min.0c943900a23c33b97e678833b149091d16e20ae29f03000b15f96b68e046fb66.css b/public/book.min.0c943900a23c33b97e678833b149091d16e20ae29f03000b15f96b68e046fb66.css
new file mode 100644
index 0000000..74e843f
--- /dev/null
+++ b/public/book.min.0c943900a23c33b97e678833b149091d16e20ae29f03000b15f96b68e046fb66.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:0 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.0d90e0e3aee6a460c02a1897d0d660497878963a10f908f2f287a4b02d4786d9.css b/public/book.min.0d90e0e3aee6a460c02a1897d0d660497878963a10f908f2f287a4b02d4786d9.css
new file mode 100644
index 0000000..7b316eb
--- /dev/null
+++ b/public/book.min.0d90e0e3aee6a460c02a1897d0d660497878963a10f908f2f287a4b02d4786d9.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}.ref{font-family:ibmplexmono,sans-serif}
\ No newline at end of file
diff --git a/public/book.min.0e42c4a26385c5963931b1b7bec4511449ae6ae6dad81aa4ae8de6ab4812a730.css b/public/book.min.0e42c4a26385c5963931b1b7bec4511449ae6ae6dad81aa4ae8de6ab4812a730.css
new file mode 100644
index 0000000..4d68073
--- /dev/null
+++ b/public/book.min.0e42c4a26385c5963931b1b7bec4511449ae6ae6dad81aa4ae8de6ab4812a730.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%;gap:0 1rem}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.0e9d2249353d535c71ea22a05afc282bedd08b8a78691f790263abeb68543b58.css b/public/book.min.0e9d2249353d535c71ea22a05afc282bedd08b8a78691f790263abeb68543b58.css
new file mode 100644
index 0000000..2a9da58
--- /dev/null
+++ b/public/book.min.0e9d2249353d535c71ea22a05afc282bedd08b8a78691f790263abeb68543b58.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border:none}td{width:30%}.markdown table tr td{padding:2rem 1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.13a65314c2279f13333ba7ccd5f931b7c4c9567742e4dc280f862d6bc256f2ec.css b/public/book.min.13a65314c2279f13333ba7ccd5f931b7c4c9567742e4dc280f862d6bc256f2ec.css
new file mode 100644
index 0000000..57b0f68
--- /dev/null
+++ b/public/book.min.13a65314c2279f13333ba7ccd5f931b7c4c9567742e4dc280f862d6bc256f2ec.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table{background:#fff}
\ No newline at end of file
diff --git a/public/book.min.158fb632e46b83994fe092523aba614621b1414122d22def9867c8ef97cbd1ee.css b/public/book.min.158fb632e46b83994fe092523aba614621b1414122d22def9867c8ef97cbd1ee.css
new file mode 100644
index 0000000..71c5038
--- /dev/null
+++ b/public/book.min.158fb632e46b83994fe092523aba614621b1414122d22def9867c8ef97cbd1ee.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:2rem;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.17de8a2f0f1c3a7eb9d94c8abcc312161f8d2e49604b42b65a0e77ed959666e6.css b/public/book.min.17de8a2f0f1c3a7eb9d94c8abcc312161f8d2e49604b42b65a0e77ed959666e6.css
new file mode 100644
index 0000000..35c9dc4
--- /dev/null
+++ b/public/book.min.17de8a2f0f1c3a7eb9d94c8abcc312161f8d2e49604b42b65a0e77ed959666e6.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:10%}td{width:30%;height:40%}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.1d0249775b1202c41220519c987d00ce7a9d0cdbdd7f2997a49c050443c97961.css b/public/book.min.1d0249775b1202c41220519c987d00ce7a9d0cdbdd7f2997a49c050443c97961.css
new file mode 100644
index 0000000..f22087d
--- /dev/null
+++ b/public/book.min.1d0249775b1202c41220519c987d00ce7a9d0cdbdd7f2997a49c050443c97961.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}a:visited .ref-header{font-family:ibmplexmono,sans-serif;color:#000}.ref-item{font-family:ibmplexmono,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.1d76fde1d64081a8e7c6c7bf431132b5f99d8e5e7766c8b74649413f9c2bba4a.css b/public/book.min.1d76fde1d64081a8e7c6c7bf431132b5f99d8e5e7766c8b74649413f9c2bba4a.css
new file mode 100644
index 0000000..8cdf2fd
--- /dev/null
+++ b/public/book.min.1d76fde1d64081a8e7c6c7bf431132b5f99d8e5e7766c8b74649413f9c2bba4a.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}.ref{font-family:ibmplexmono,sans-serif;text-decoration:blue}
\ No newline at end of file
diff --git a/public/book.min.1e9436a0c6e26c00ff3ad8003457f177f94eba1bb28e5ceb37f7fac177a28364.css b/public/book.min.1e9436a0c6e26c00ff3ad8003457f177f94eba1bb28e5ceb37f7fac177a28364.css
new file mode 100644
index 0000000..efcbcf1
--- /dev/null
+++ b/public/book.min.1e9436a0c6e26c00ff3ad8003457f177f94eba1bb28e5ceb37f7fac177a28364.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.1ea03809235b650ce69038dd075dc4ebc4ee1900da5122d21d790a60f75de8b3.css b/public/book.min.1ea03809235b650ce69038dd075dc4ebc4ee1900da5122d21d790a60f75de8b3.css
new file mode 100644
index 0000000..7602e83
--- /dev/null
+++ b/public/book.min.1ea03809235b650ce69038dd075dc4ebc4ee1900da5122d21d790a60f75de8b3.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}a:hover{color:orange}a:focus{color:orange}a:active{color:orange}
\ No newline at end of file
diff --git a/public/book.min.21d4a3dfbd5b7a6675db53f2bd23b4e83e77c69f85290fca9fc894555f7892c4.css b/public/book.min.21d4a3dfbd5b7a6675db53f2bd23b4e83e77c69f85290fca9fc894555f7892c4.css
new file mode 100644
index 0000000..5d22de5
--- /dev/null
+++ b/public/book.min.21d4a3dfbd5b7a6675db53f2bd23b4e83e77c69f85290fca9fc894555f7892c4.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%;gap:1rem}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.2539fced13c1e5377874d9c0c17917a902e6f0b8cc48305d9c0932daee67a05e.css b/public/book.min.2539fced13c1e5377874d9c0c17917a902e6f0b8cc48305d9c0932daee67a05e.css
new file mode 100644
index 0000000..8cc9cc3
--- /dev/null
+++ b/public/book.min.2539fced13c1e5377874d9c0c17917a902e6f0b8cc48305d9c0932daee67a05e.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}table{border:none;width:100%}table tr th:empty{display:none}
\ No newline at end of file
diff --git a/public/book.min.27f1c8233e0f81d6b57565d975a13883ea8af36fc02d099db5c21afa2edb0af8.css b/public/book.min.27f1c8233e0f81d6b57565d975a13883ea8af36fc02d099db5c21afa2edb0af8.css
new file mode 100644
index 0000000..e2ade6a
--- /dev/null
+++ b/public/book.min.27f1c8233e0f81d6b57565d975a13883ea8af36fc02d099db5c21afa2edb0af8.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr td{padding:0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.2b3fb1b9fae296316b75333bbbadae4800964136df28327ff0bf24616c0038ca.css b/public/book.min.2b3fb1b9fae296316b75333bbbadae4800964136df28327ff0bf24616c0038ca.css
new file mode 100644
index 0000000..bad6623
--- /dev/null
+++ b/public/book.min.2b3fb1b9fae296316b75333bbbadae4800964136df28327ff0bf24616c0038ca.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:2rem 1rem;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.2ca27541230e4d4524e24a7dedfea6b13e89c16ee5853f8a54abe6fe325738b6.css b/public/book.min.2ca27541230e4d4524e24a7dedfea6b13e89c16ee5853f8a54abe6fe325738b6.css
new file mode 100644
index 0000000..fd28295
--- /dev/null
+++ b/public/book.min.2ca27541230e4d4524e24a7dedfea6b13e89c16ee5853f8a54abe6fe325738b6.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.2f7c6b4f2c6a85108b7038fb4109119fb94fb6c11c1b3210dcc2db68e3a318e6.css b/public/book.min.2f7c6b4f2c6a85108b7038fb4109119fb94fb6c11c1b3210dcc2db68e3a318e6.css
new file mode 100644
index 0000000..9a17d0b
--- /dev/null
+++ b/public/book.min.2f7c6b4f2c6a85108b7038fb4109119fb94fb6c11c1b3210dcc2db68e3a318e6.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}
\ No newline at end of file
diff --git a/public/book.min.3799e8906eaebb64f51edda147d06e333d5bc0012219bb61df4eb33975a242f8.css b/public/book.min.3799e8906eaebb64f51edda147d06e333d5bc0012219bb61df4eb33975a242f8.css
new file mode 100644
index 0000000..f1a7cb0
--- /dev/null
+++ b/public/book.min.3799e8906eaebb64f51edda147d06e333d5bc0012219bb61df4eb33975a242f8.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}a:link{color:blue}.markdown a:visited{color:purple}a:hover{color:orange}a:focus{color:green}a:active{color:red}
\ No newline at end of file
diff --git a/public/book.min.3839fefeaa4f521b6ae63e62264dfbb1af36de53744d3a1856962e774d29b005.css b/public/book.min.3839fefeaa4f521b6ae63e62264dfbb1af36de53744d3a1856962e774d29b005.css
new file mode 100644
index 0000000..d3775b0
--- /dev/null
+++ b/public/book.min.3839fefeaa4f521b6ae63e62264dfbb1af36de53744d3a1856962e774d29b005.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.3ad3af9d24d642b875cd453f3d2ab6bb0840e57e347335ecb3db9ae6b34f5cf5.css b/public/book.min.3ad3af9d24d642b875cd453f3d2ab6bb0840e57e347335ecb3db9ae6b34f5cf5.css
new file mode 100644
index 0000000..55095cb
--- /dev/null
+++ b/public/book.min.3ad3af9d24d642b875cd453f3d2ab6bb0840e57e347335ecb3db9ae6b34f5cf5.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700;color:#fff}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.3af860061526e6bfcb2de3ace1a403b45a7f1b1f1a4257f32dbf305dd22a0453.css b/public/book.min.3af860061526e6bfcb2de3ace1a403b45a7f1b1f1a4257f32dbf305dd22a0453.css
new file mode 100644
index 0000000..f3ca354
--- /dev/null
+++ b/public/book.min.3af860061526e6bfcb2de3ace1a403b45a7f1b1f1a4257f32dbf305dd22a0453.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:20%}
\ No newline at end of file
diff --git a/public/book.min.3ca8c8ba07a84f4e78165a553ed24d049467143106f678c901012be17613c243.css b/public/book.min.3ca8c8ba07a84f4e78165a553ed24d049467143106f678c901012be17613c243.css
new file mode 100644
index 0000000..48e98ca
--- /dev/null
+++ b/public/book.min.3ca8c8ba07a84f4e78165a553ed24d049467143106f678c901012be17613c243.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:0 25px}td{width:30%;height:40%}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.3caff1cdb1c0e626deb151656ccfc0f394c3dfad0396701122600d6093339ef4.css b/public/book.min.3caff1cdb1c0e626deb151656ccfc0f394c3dfad0396701122600d6093339ef4.css
new file mode 100644
index 0000000..a3f5aa2
--- /dev/null
+++ b/public/book.min.3caff1cdb1c0e626deb151656ccfc0f394c3dfad0396701122600d6093339ef4.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.25em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:1em}
\ No newline at end of file
diff --git a/public/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css b/public/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css
new file mode 100644
index 0000000..74e7f6b
--- /dev/null
+++ b/public/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 4rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%;gap:.75rem 0}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.443261f7ab53cad405f065a6f1c1cc84b8d139f95323f911bc1a08177148ace5.css b/public/book.min.443261f7ab53cad405f065a6f1c1cc84b8d139f95323f911bc1a08177148ace5.css
new file mode 100644
index 0000000..351a7a7
--- /dev/null
+++ b/public/book.min.443261f7ab53cad405f065a6f1c1cc84b8d139f95323f911bc1a08177148ace5.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}
\ No newline at end of file
diff --git a/public/book.min.4676687a6b6213d7f7a067e5274431246631d9dfaca74182165a8ab43f88eaf7.css b/public/book.min.4676687a6b6213d7f7a067e5274431246631d9dfaca74182165a8ab43f88eaf7.css
new file mode 100644
index 0000000..e0d36d1
--- /dev/null
+++ b/public/book.min.4676687a6b6213d7f7a067e5274431246631d9dfaca74182165a8ab43f88eaf7.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.47a14214c48deadd5aab5d135d4f9360f936f281cddd7b22470c8d82871b42cf.css b/public/book.min.47a14214c48deadd5aab5d135d4f9360f936f281cddd7b22470c8d82871b42cf.css
new file mode 100644
index 0000000..2c9c58f
--- /dev/null
+++ b/public/book.min.47a14214c48deadd5aab5d135d4f9360f936f281cddd7b22470c8d82871b42cf.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:9pt}
\ No newline at end of file
diff --git a/public/book.min.48017641984d0492bb1b15747ebffbfda16067dfe0f135879b6a0dc312c36124.css b/public/book.min.48017641984d0492bb1b15747ebffbfda16067dfe0f135879b6a0dc312c36124.css
new file mode 100644
index 0000000..f3b1875
--- /dev/null
+++ b/public/book.min.48017641984d0492bb1b15747ebffbfda16067dfe0f135879b6a0dc312c36124.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}.ref a{font-family:ibmplexmono,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.4946d1be45d0a8c0d823155d8932ddb6d9c8255c2afd646dceabf79e434bd8d6.css b/public/book.min.4946d1be45d0a8c0d823155d8932ddb6d9c8255c2afd646dceabf79e434bd8d6.css
new file mode 100644
index 0000000..94f2083
--- /dev/null
+++ b/public/book.min.4946d1be45d0a8c0d823155d8932ddb6d9c8255c2afd646dceabf79e434bd8d6.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.4b1e6033c8e8c4621852c9288349caddfda8351226bd8f535de671165cc485b1.css b/public/book.min.4b1e6033c8e8c4621852c9288349caddfda8351226bd8f535de671165cc485b1.css
new file mode 100644
index 0000000..f3fb912
--- /dev/null
+++ b/public/book.min.4b1e6033c8e8c4621852c9288349caddfda8351226bd8f535de671165cc485b1.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:30% 70%}.grid-item{height:1.6rem}
\ No newline at end of file
diff --git a/public/book.min.4da2860eeeedd961343692b8958597cb0840071f11dc2224b89dab98c007fdbe.css b/public/book.min.4da2860eeeedd961343692b8958597cb0840071f11dc2224b89dab98c007fdbe.css
new file mode 100644
index 0000000..5988c17
--- /dev/null
+++ b/public/book.min.4da2860eeeedd961343692b8958597cb0840071f11dc2224b89dab98c007fdbe.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}tr{padding-bottom:1em}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.51376eee9ddaffeab3dfe8853fb9357ec9434e5702c4a923aed5257b2b035b77.css b/public/book.min.51376eee9ddaffeab3dfe8853fb9357ec9434e5702c4a923aed5257b2b035b77.css
new file mode 100644
index 0000000..4a1b519
--- /dev/null
+++ b/public/book.min.51376eee9ddaffeab3dfe8853fb9357ec9434e5702c4a923aed5257b2b035b77.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}
\ No newline at end of file
diff --git a/public/book.min.54d2a25f48eacdb10939e523d045eac4b9b2e57ffca4692a0bff064b8a96511a.css b/public/book.min.54d2a25f48eacdb10939e523d045eac4b9b2e57ffca4692a0bff064b8a96511a.css
new file mode 100644
index 0000000..5aef8d5
--- /dev/null
+++ b/public/book.min.54d2a25f48eacdb10939e523d045eac4b9b2e57ffca4692a0bff064b8a96511a.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:10pt}
\ No newline at end of file
diff --git a/public/book.min.5502b34620e12e7c1e4d4053a7547a4746cc0a5bc05f817d410053a1f569ce23.css b/public/book.min.5502b34620e12e7c1e4d4053a7547a4746cc0a5bc05f817d410053a1f569ce23.css
new file mode 100644
index 0000000..e1d0d1a
--- /dev/null
+++ b/public/book.min.5502b34620e12e7c1e4d4053a7547a4746cc0a5bc05f817d410053a1f569ce23.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader h3{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:2rem 1rem;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.57890adbbfef6924de091c07d1811e85275c09d423c856646bcd54adefcce28b.css b/public/book.min.57890adbbfef6924de091c07d1811e85275c09d423c856646bcd54adefcce28b.css
new file mode 100644
index 0000000..688221f
--- /dev/null
+++ b/public/book.min.57890adbbfef6924de091c07d1811e85275c09d423c856646bcd54adefcce28b.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:50%}td{width:30%;height:40%}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.59c28be0de71eaf9ea25e02a8500e39435936e3e85a58a2545a515cc1419bc76.css b/public/book.min.59c28be0de71eaf9ea25e02a8500e39435936e3e85a58a2545a515cc1419bc76.css
new file mode 100644
index 0000000..eb100d4
--- /dev/null
+++ b/public/book.min.59c28be0de71eaf9ea25e02a8500e39435936e3e85a58a2545a515cc1419bc76.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:2rem 1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.5a812bb0f5ab2a9bfe55c303d46c73a64c417e37a8e795002394d80704f78ed8.css b/public/book.min.5a812bb0f5ab2a9bfe55c303d46c73a64c417e37a8e795002394d80704f78ed8.css
new file mode 100644
index 0000000..1c51001
--- /dev/null
+++ b/public/book.min.5a812bb0f5ab2a9bfe55c303d46c73a64c417e37a8e795002394d80704f78ed8.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}table tr th:empty{display:none}
\ No newline at end of file
diff --git a/public/book.min.5b6d51bcc51bc04792507df0cad46a63ae47fd1987793ffb1cd76311de785de8.css b/public/book.min.5b6d51bcc51bc04792507df0cad46a63ae47fd1987793ffb1cd76311de785de8.css
new file mode 100644
index 0000000..7d2257f
--- /dev/null
+++ b/public/book.min.5b6d51bcc51bc04792507df0cad46a63ae47fd1987793ffb1cd76311de785de8.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.5ce2b8478174d06bf99294ae08b4901564c67a81f93a20b871d319023d81e9d9.css b/public/book.min.5ce2b8478174d06bf99294ae08b4901564c67a81f93a20b871d319023d81e9d9.css
new file mode 100644
index 0000000..68ab8f0
--- /dev/null
+++ b/public/book.min.5ce2b8478174d06bf99294ae08b4901564c67a81f93a20b871d319023d81e9d9.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:2rem 10rem 2rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.5d49f7be6c1c4ecc5ecdabf17bc22eb97de6e5180a04c5573a741afe0beb4672.css b/public/book.min.5d49f7be6c1c4ecc5ecdabf17bc22eb97de6e5180a04c5573a741afe0beb4672.css
new file mode 100644
index 0000000..f61eecb
--- /dev/null
+++ b/public/book.min.5d49f7be6c1c4ecc5ecdabf17bc22eb97de6e5180a04c5573a741afe0beb4672.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:2rem 1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.5fd603082890a909136ef6c5c5431a4bdfad3f52da0b692e10e211c9ea991408.css b/public/book.min.5fd603082890a909136ef6c5c5431a4bdfad3f52da0b692e10e211c9ea991408.css
new file mode 100644
index 0000000..d0043bf
--- /dev/null
+++ b/public/book.min.5fd603082890a909136ef6c5c5431a4bdfad3f52da0b692e10e211c9ea991408.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}
\ No newline at end of file
diff --git a/public/book.min.61479c464d87c76806c0d40d5d45c0ef3b99886dfb028a0be7e29b28b913c6f7.css b/public/book.min.61479c464d87c76806c0d40d5d45c0ef3b99886dfb028a0be7e29b28b913c6f7.css
new file mode 100644
index 0000000..d0e056d
--- /dev/null
+++ b/public/book.min.61479c464d87c76806c0d40d5d45c0ef3b99886dfb028a0be7e29b28b913c6f7.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:1rem 0}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.637eed593001710b067ff3937fc02ae912709b5c530451b9ab0f8c55292bbf0f.css b/public/book.min.637eed593001710b067ff3937fc02ae912709b5c530451b9ab0f8c55292bbf0f.css
new file mode 100644
index 0000000..59535f0
--- /dev/null
+++ b/public/book.min.637eed593001710b067ff3937fc02ae912709b5c530451b9ab0f8c55292bbf0f.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:2rem 1rem;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.6a8bcdb87b2d5ed74bc6c6b905c85749ca36be6f2b4635b070ce2be57053aec1.css b/public/book.min.6a8bcdb87b2d5ed74bc6c6b905c85749ca36be6f2b4635b070ce2be57053aec1.css
new file mode 100644
index 0000000..8a727b1
--- /dev/null
+++ b/public/book.min.6a8bcdb87b2d5ed74bc6c6b905c85749ca36be6f2b4635b070ce2be57053aec1.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}a:visited .ref{font-family:ibmplexmono,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.6dd25fbc3304a7035075a440a03a30c9a002e97e28b4cd2d2d9855c7c9088169.css b/public/book.min.6dd25fbc3304a7035075a440a03a30c9a002e97e28b4cd2d2d9855c7c9088169.css
new file mode 100644
index 0000000..d8d143e
--- /dev/null
+++ b/public/book.min.6dd25fbc3304a7035075a440a03a30c9a002e97e28b4cd2d2d9855c7c9088169.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdowntable tr td{padding:0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.717e02068d95cf79fc4a97fd9cd56cf4f3b70eba27526efb5c6a9d1f2cb825a2.css b/public/book.min.717e02068d95cf79fc4a97fd9cd56cf4f3b70eba27526efb5c6a9d1f2cb825a2.css
new file mode 100644
index 0000000..d1536d5
--- /dev/null
+++ b/public/book.min.717e02068d95cf79fc4a97fd9cd56cf4f3b70eba27526efb5c6a9d1f2cb825a2.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:2rem 5rem;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.717f4d6769abddfa055a6b7965889fcbdfb7d78b0ae53125682012ff5c666381.css b/public/book.min.717f4d6769abddfa055a6b7965889fcbdfb7d78b0ae53125682012ff5c666381.css
new file mode 100644
index 0000000..27cc5cf
--- /dev/null
+++ b/public/book.min.717f4d6769abddfa055a6b7965889fcbdfb7d78b0ae53125682012ff5c666381.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown.parameters table tr td{padding:0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.76929abc828634b27169df8085c79eef4b1adc123192b661f57c33c92b977c28.css b/public/book.min.76929abc828634b27169df8085c79eef4b1adc123192b661f57c33c92b977c28.css
new file mode 100644
index 0000000..6cb59de
--- /dev/null
+++ b/public/book.min.76929abc828634b27169df8085c79eef4b1adc123192b661f57c33c92b977c28.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.75em}table tr th:empty{display:none;border:none}
\ No newline at end of file
diff --git a/public/book.min.76ae6f26e43834193a289bc4801951c91e9504cd09c4bb64abccc6e7650cac73.css b/public/book.min.76ae6f26e43834193a289bc4801951c91e9504cd09c4bb64abccc6e7650cac73.css
new file mode 100644
index 0000000..3d3d03a
--- /dev/null
+++ b/public/book.min.76ae6f26e43834193a289bc4801951c91e9504cd09c4bb64abccc6e7650cac73.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}tr{background:#fff}
\ No newline at end of file
diff --git a/public/book.min.76da4a9ad7088e0385721856550b87762480d7ddbb0e2c12b3a561abda21e224.css b/public/book.min.76da4a9ad7088e0385721856550b87762480d7ddbb0e2c12b3a561abda21e224.css
new file mode 100644
index 0000000..8501733
--- /dev/null
+++ b/public/book.min.76da4a9ad7088e0385721856550b87762480d7ddbb0e2c12b3a561abda21e224.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:30% 70%}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.7bf4d6ba9fab661fdcf1a25c6d3162f88fd2bded862432ca9207e7fe2e344341.css b/public/book.min.7bf4d6ba9fab661fdcf1a25c6d3162f88fd2bded862432ca9207e7fe2e344341.css
new file mode 100644
index 0000000..57b0438
--- /dev/null
+++ b/public/book.min.7bf4d6ba9fab661fdcf1a25c6d3162f88fd2bded862432ca9207e7fe2e344341.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.7ef099dcebc07a2aac232bdc5211e8caaee64db782fc6509ea85d690eea99b71.css b/public/book.min.7ef099dcebc07a2aac232bdc5211e8caaee64db782fc6509ea85d690eea99b71.css
new file mode 100644
index 0000000..ac75f2e
--- /dev/null
+++ b/public/book.min.7ef099dcebc07a2aac232bdc5211e8caaee64db782fc6509ea85d690eea99b71.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:auto auto}.grid-item{height:1.6rem}
\ No newline at end of file
diff --git a/public/book.min.820e4d97bf8106897da2c21925c5595066754edc466600b61e9d236ad2e6ce7b.css b/public/book.min.820e4d97bf8106897da2c21925c5595066754edc466600b61e9d236ad2e6ce7b.css
new file mode 100644
index 0000000..6f3b135
--- /dev/null
+++ b/public/book.min.820e4d97bf8106897da2c21925c5595066754edc466600b61e9d236ad2e6ce7b.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr{background:#fff}
\ No newline at end of file
diff --git a/public/book.min.88c57e9e45b2b3f81722d8bf8a09668d1c7aa866d348fa5d8135a7a82baf2f5f.css b/public/book.min.88c57e9e45b2b3f81722d8bf8a09668d1c7aa866d348fa5d8135a7a82baf2f5f.css
new file mode 100644
index 0000000..64f26e3
--- /dev/null
+++ b/public/book.min.88c57e9e45b2b3f81722d8bf8a09668d1c7aa866d348fa5d8135a7a82baf2f5f.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.5em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:1em}
\ No newline at end of file
diff --git a/public/book.min.8910f50bcf80173a3843f7c7516c6ce8c0d41ad99b40352bfae88dad8e08444c.css b/public/book.min.8910f50bcf80173a3843f7c7516c6ce8c0d41ad99b40352bfae88dad8e08444c.css
new file mode 100644
index 0000000..ef45335
--- /dev/null
+++ b/public/book.min.8910f50bcf80173a3843f7c7516c6ce8c0d41ad99b40352bfae88dad8e08444c.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.parameters table tr td{padding:0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.8916f1215ac11c215525244ead872387d966ce05a7f32222bc72ab74e700f16d.css b/public/book.min.8916f1215ac11c215525244ead872387d966ce05a7f32222bc72ab74e700f16d.css
new file mode 100644
index 0000000..e2e000d
--- /dev/null
+++ b/public/book.min.8916f1215ac11c215525244ead872387d966ce05a7f32222bc72ab74e700f16d.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}a:link{color:orange}.markdown a:visited{color:orange}a:hover{color:orange}a:focus{color:orange}a:active{color:orange}
\ No newline at end of file
diff --git a/public/book.min.8942f18f54b86461f638cf18e8f23061da7a44cfd27d8160398610c4f6105ff7.css b/public/book.min.8942f18f54b86461f638cf18e8f23061da7a44cfd27d8160398610c4f6105ff7.css
new file mode 100644
index 0000000..ba51317
--- /dev/null
+++ b/public/book.min.8942f18f54b86461f638cf18e8f23061da7a44cfd27d8160398610c4f6105ff7.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-color:oragne}
\ No newline at end of file
diff --git a/public/book.min.8985f01ddcc5570565234ace16d7bfbe1a96253aeec50fe30888392189d8e978.css b/public/book.min.8985f01ddcc5570565234ace16d7bfbe1a96253aeec50fe30888392189d8e978.css
new file mode 100644
index 0000000..31f33a2
--- /dev/null
+++ b/public/book.min.8985f01ddcc5570565234ace16d7bfbe1a96253aeec50fe30888392189d8e978.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:1em}
\ No newline at end of file
diff --git a/public/book.min.8a42b64d326ced9c7104d19fe9eb2747a7213ffa031f01bee26c4ef1b2691362.css b/public/book.min.8a42b64d326ced9c7104d19fe9eb2747a7213ffa031f01bee26c4ef1b2691362.css
new file mode 100644
index 0000000..f579f6a
--- /dev/null
+++ b/public/book.min.8a42b64d326ced9c7104d19fe9eb2747a7213ffa031f01bee26c4ef1b2691362.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%;height:40%}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.8c11d334769080437fe0788f17987361c62ebc9877946527f372331bcec1c639.css b/public/book.min.8c11d334769080437fe0788f17987361c62ebc9877946527f372331bcec1c639.css
new file mode 100644
index 0000000..54bbba0
--- /dev/null
+++ b/public/book.min.8c11d334769080437fe0788f17987361c62ebc9877946527f372331bcec1c639.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:2rem 1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css b/public/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css
new file mode 100644
index 0000000..38e06f9
--- /dev/null
+++ b/public/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%;gap:.75rem 0}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.906be3c02a9f7b255ca5dd9efeaad8a43cc8dd29a6447b8a06f63fd7ff0b859d.css b/public/book.min.906be3c02a9f7b255ca5dd9efeaad8a43cc8dd29a6447b8a06f63fd7ff0b859d.css
new file mode 100644
index 0000000..8864e1c
--- /dev/null
+++ b/public/book.min.906be3c02a9f7b255ca5dd9efeaad8a43cc8dd29a6447b8a06f63fd7ff0b859d.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}.markdown .ref{font-family:ibmplexmono,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.92082d667237dd69bf8850f78cf90dc5f45ac8d1f74c2b34f70af6a4e2911cad.css b/public/book.min.92082d667237dd69bf8850f78cf90dc5f45ac8d1f74c2b34f70af6a4e2911cad.css
new file mode 100644
index 0000000..0132ebf
--- /dev/null
+++ b/public/book.min.92082d667237dd69bf8850f78cf90dc5f45ac8d1f74c2b34f70af6a4e2911cad.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.93ae5b81037f40292f959a8ce792bd0bc8f5eb40cafb0ef9be4e796399869921.css b/public/book.min.93ae5b81037f40292f959a8ce792bd0bc8f5eb40cafb0ef9be4e796399869921.css
new file mode 100644
index 0000000..caab8f9
--- /dev/null
+++ b/public/book.min.93ae5b81037f40292f959a8ce792bd0bc8f5eb40cafb0ef9be4e796399869921.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}a:visited .ref-header{font-family:ibmplexmono,sans-serif;color:#000}.ref-item{font-family:ibmplexmono,sans-serif;color:#000}.ref-info{font-family:ibmplexmono,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.94f7832c0f6b467ce82af835f857dc8dacea8a0ca96f464d2df0f896ecc4a6ea.css b/public/book.min.94f7832c0f6b467ce82af835f857dc8dacea8a0ca96f464d2df0f896ecc4a6ea.css
new file mode 100644
index 0000000..f5f998c
--- /dev/null
+++ b/public/book.min.94f7832c0f6b467ce82af835f857dc8dacea8a0ca96f464d2df0f896ecc4a6ea.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.967f0dea362c19f3c83c6ca907cc3a9298e6c7549c4bccbc954d9079e2dc7bdb.css b/public/book.min.967f0dea362c19f3c83c6ca907cc3a9298e6c7549c4bccbc954d9079e2dc7bdb.css
new file mode 100644
index 0000000..50a7e8a
--- /dev/null
+++ b/public/book.min.967f0dea362c19f3c83c6ca907cc3a9298e6c7549c4bccbc954d9079e2dc7bdb.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:8pt}
\ No newline at end of file
diff --git a/public/book.min.9b3e0f300a0ab4c4af5071af879388de75b2fb08f9985369711762efe01eb232.css b/public/book.min.9b3e0f300a0ab4c4af5071af879388de75b2fb08f9985369711762efe01eb232.css
new file mode 100644
index 0000000..3a23108
--- /dev/null
+++ b/public/book.min.9b3e0f300a0ab4c4af5071af879388de75b2fb08f9985369711762efe01eb232.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-color:orange}
\ No newline at end of file
diff --git a/public/book.min.9fd0b56cfc68da4ef0e88078825e9e631d0756ff04ae6f600e638bfc4b853335.css b/public/book.min.9fd0b56cfc68da4ef0e88078825e9e631d0756ff04ae6f600e638bfc4b853335.css
new file mode 100644
index 0000000..df1df82
--- /dev/null
+++ b/public/book.min.9fd0b56cfc68da4ef0e88078825e9e631d0756ff04ae6f600e638bfc4b853335.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%;vertical-align:bottom}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.acc09f8a75ce621f794117226fdaa777181171bba8048e2a2769c9b05348eed1.css b/public/book.min.acc09f8a75ce621f794117226fdaa777181171bba8048e2a2769c9b05348eed1.css
new file mode 100644
index 0000000..7877ccc
--- /dev/null
+++ b/public/book.min.acc09f8a75ce621f794117226fdaa777181171bba8048e2a2769c9b05348eed1.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%}.grid-item{height:1.6rem}
\ No newline at end of file
diff --git a/public/book.min.ad941185ec672ff4e5f02c9bcc02bdcea1dbcea6b15b088bff9a96da40b8bcef.css b/public/book.min.ad941185ec672ff4e5f02c9bcc02bdcea1dbcea6b15b088bff9a96da40b8bcef.css
new file mode 100644
index 0000000..b6103b8
--- /dev/null
+++ b/public/book.min.ad941185ec672ff4e5f02c9bcc02bdcea1dbcea6b15b088bff9a96da40b8bcef.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}.ref{font-family:ibmplexmono,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.b5a6876a3021b6c0fc9690f7553828e2d022621bc3a1ea039b9d560f59d0c39b.css b/public/book.min.b5a6876a3021b6c0fc9690f7553828e2d022621bc3a1ea039b9d560f59d0c39b.css
new file mode 100644
index 0000000..d8a3532
--- /dev/null
+++ b/public/book.min.b5a6876a3021b6c0fc9690f7553828e2d022621bc3a1ea039b9d560f59d0c39b.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.b67de44bd6dabbba8d0cac1f4727c3b0373e09fbcb1d4dc9c9e393721950b9f3.css b/public/book.min.b67de44bd6dabbba8d0cac1f4727c3b0373e09fbcb1d4dc9c9e393721950b9f3.css
new file mode 100644
index 0000000..757eb86
--- /dev/null
+++ b/public/book.min.b67de44bd6dabbba8d0cac1f4727c3b0373e09fbcb1d4dc9c9e393721950b9f3.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:.5rem 1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.b727ba30f5db58d410a60a05642b7bbbf9e31a0ef79c47246dec25e32187f47a.css b/public/book.min.b727ba30f5db58d410a60a05642b7bbbf9e31a0ef79c47246dec25e32187f47a.css
new file mode 100644
index 0000000..ba437eb
--- /dev/null
+++ b/public/book.min.b727ba30f5db58d410a60a05642b7bbbf9e31a0ef79c47246dec25e32187f47a.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%}.markdown table tr td{padding:2rem 5rem 2rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.bec96ec420693661723d4037d75485a06b434e976c449542c14e66609bd098eb.css b/public/book.min.bec96ec420693661723d4037d75485a06b434e976c449542c14e66609bd098eb.css
new file mode 100644
index 0000000..1019a1d
--- /dev/null
+++ b/public/book.min.bec96ec420693661723d4037d75485a06b434e976c449542c14e66609bd098eb.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown .parameters table tr td{padding:0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.bf33e025446443a4a8bbadfbc95aac19489e510d092c8a796fb1949e4c5bb4aa.css b/public/book.min.bf33e025446443a4a8bbadfbc95aac19489e510d092c8a796fb1949e4c5bb4aa.css
new file mode 100644
index 0000000..c006583
--- /dev/null
+++ b/public/book.min.bf33e025446443a4a8bbadfbc95aac19489e510d092c8a796fb1949e4c5bb4aa.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}.markdown table{border-color:orange}
\ No newline at end of file
diff --git a/public/book.min.c01a3f52457b938f995994f2db80632b7a9894df67a6364cd8e49e47be935636.css b/public/book.min.c01a3f52457b938f995994f2db80632b7a9894df67a6364cd8e49e47be935636.css
new file mode 100644
index 0000000..9170835
--- /dev/null
+++ b/public/book.min.c01a3f52457b938f995994f2db80632b7a9894df67a6364cd8e49e47be935636.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.c2d5b829467d9809f85bef6fff45226e7c3c500a3ec7366fc01d03e80cbfe80e.css b/public/book.min.c2d5b829467d9809f85bef6fff45226e7c3c500a3ec7366fc01d03e80cbfe80e.css
new file mode 100644
index 0000000..9a80350
--- /dev/null
+++ b/public/book.min.c2d5b829467d9809f85bef6fff45226e7c3c500a3ec7366fc01d03e80cbfe80e.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.ca4773c7d802def2ce0a306e49a36ce75a40835f84f4f752adeba935845dc967.css b/public/book.min.ca4773c7d802def2ce0a306e49a36ce75a40835f84f4f752adeba935845dc967.css
new file mode 100644
index 0000000..8ff1ddb
--- /dev/null
+++ b/public/book.min.ca4773c7d802def2ce0a306e49a36ce75a40835f84f4f752adeba935845dc967.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%;gap:1rem 0}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.cbb9dd6f56abebda9e75352b5ff02226a1b1f278df3eedf92bd3019076a156ed.css b/public/book.min.cbb9dd6f56abebda9e75352b5ff02226a1b1f278df3eedf92bd3019076a156ed.css
new file mode 100644
index 0000000..4dd2021
--- /dev/null
+++ b/public/book.min.cbb9dd6f56abebda9e75352b5ff02226a1b1f278df3eedf92bd3019076a156ed.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:40%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.cd9a024b85590e39ab9fd299169260ac9f2cf9252e2c591081be91cf2d66bdfe.css b/public/book.min.cd9a024b85590e39ab9fd299169260ac9f2cf9252e2c591081be91cf2d66bdfe.css
new file mode 100644
index 0000000..a3f570d
--- /dev/null
+++ b/public/book.min.cd9a024b85590e39ab9fd299169260ac9f2cf9252e2c591081be91cf2d66bdfe.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}.markdown table{border:none}td{width:30%}.markdown table tr td{padding:2rem 1rem;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.cedd874628e69a6da2ee528341788ae001afb7e2e7babce01263b2f3d021ff06.css b/public/book.min.cedd874628e69a6da2ee528341788ae001afb7e2e7babce01263b2f3d021ff06.css
new file mode 100644
index 0000000..3055eb5
--- /dev/null
+++ b/public/book.min.cedd874628e69a6da2ee528341788ae001afb7e2e7babce01263b2f3d021ff06.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}
\ No newline at end of file
diff --git a/public/book.min.d076dcf8dff6714cc85ff6f9d2a3387666e734785959f37b7448525a983e3774.css b/public/book.min.d076dcf8dff6714cc85ff6f9d2a3387666e734785959f37b7448525a983e3774.css
new file mode 100644
index 0000000..dfa4899
--- /dev/null
+++ b/public/book.min.d076dcf8dff6714cc85ff6f9d2a3387666e734785959f37b7448525a983e3774.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%;gap:0% 10%}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.de6dcc60710807ef9a1cf5ba94d281fb97478fd32ae8fae3cb78d85dca723788.css b/public/book.min.de6dcc60710807ef9a1cf5ba94d281fb97478fd32ae8fae3cb78d85dca723788.css
new file mode 100644
index 0000000..5c3ce96
--- /dev/null
+++ b/public/book.min.de6dcc60710807ef9a1cf5ba94d281fb97478fd32ae8fae3cb78d85dca723788.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}.markdown ref{font-family:ibmplexmono,sans-serif;color:#000}
\ No newline at end of file
diff --git a/public/book.min.dfc0d503e591842fd27120ac0a3962c32df6cbccc3abab8194fbaa9602e53ed8.css b/public/book.min.dfc0d503e591842fd27120ac0a3962c32df6cbccc3abab8194fbaa9602e53ed8.css
new file mode 100644
index 0000000..f2de8a3
--- /dev/null
+++ b/public/book.min.dfc0d503e591842fd27120ac0a3962c32df6cbccc3abab8194fbaa9602e53ed8.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 780%}.grid-item{height:auto}
\ No newline at end of file
diff --git a/public/book.min.e25dd85b3a0c23cdac7b33c3701bb4f3b50031d3708af8624945c5a601395567.css b/public/book.min.e25dd85b3a0c23cdac7b33c3701bb4f3b50031d3708af8624945c5a601395567.css
new file mode 100644
index 0000000..dce0e36
--- /dev/null
+++ b/public/book.min.e25dd85b3a0c23cdac7b33c3701bb4f3b50031d3708af8624945c5a601395567.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:30%;height:40%}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.e4855f3ccb7c80afa9ea474950ae2c146f8d7e3f5f456ac8ef61366ac0608b02.css b/public/book.min.e4855f3ccb7c80afa9ea474950ae2c146f8d7e3f5f456ac8ef61366ac0608b02.css
new file mode 100644
index 0000000..f254ba2
--- /dev/null
+++ b/public/book.min.e4855f3ccb7c80afa9ea474950ae2c146f8d7e3f5f456ac8ef61366ac0608b02.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:4rem 1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.e5a50029783f9371bdaf86e62cd63c01e97a2f65b011d3d31c79322eded67ae3.css b/public/book.min.e5a50029783f9371bdaf86e62cd63c01e97a2f65b011d3d31c79322eded67ae3.css
new file mode 100644
index 0000000..5f606fa
--- /dev/null
+++ b/public/book.min.e5a50029783f9371bdaf86e62cd63c01e97a2f65b011d3d31c79322eded67ae3.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown .parameters table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.e86ce09cd11e0ad6c87a449244a54affc097e820e189d1fdcf110546267b104e.css b/public/book.min.e86ce09cd11e0ad6c87a449244a54affc097e820e189d1fdcf110546267b104e.css
new file mode 100644
index 0000000..103627a
--- /dev/null
+++ b/public/book.min.e86ce09cd11e0ad6c87a449244a54affc097e820e189d1fdcf110546267b104e.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}td{width:50%}
\ No newline at end of file
diff --git a/public/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css b/public/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css
new file mode 100644
index 0000000..2add0aa
--- /dev/null
+++ b/public/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}
\ No newline at end of file
diff --git a/public/book.min.ee92c3780008de58e5dc136186d81f9cfff00747c98c3c1dae5760bf04fba8cf.css b/public/book.min.ee92c3780008de58e5dc136186d81f9cfff00747c98c3c1dae5760bf04fba8cf.css
new file mode 100644
index 0000000..1d77f39
--- /dev/null
+++ b/public/book.min.ee92c3780008de58e5dc136186d81f9cfff00747c98c3c1dae5760bf04fba8cf.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}a:visited .ref-header{font-family:ibmplexmono,monospace;color:#000}.ref-item{font-family:ibmplexmono,monospace;color:#000}.ref-info{font-family:inter,sans-serif;color:#000;font-size:12pt}
\ No newline at end of file
diff --git a/public/book.min.efcd5f8aa554ddde02df57396d583a6abe45c9bb8cdf8442c643036ee0a2cb49.css b/public/book.min.efcd5f8aa554ddde02df57396d583a6abe45c9bb8cdf8442c643036ee0a2cb49.css
new file mode 100644
index 0000000..8a3298c
--- /dev/null
+++ b/public/book.min.efcd5f8aa554ddde02df57396d583a6abe45c9bb8cdf8442c643036ee0a2cb49.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-color:none}
\ No newline at end of file
diff --git a/public/book.min.f0844eb1b9e55a1aa15f4c4d9f6cb2aed7ea3d74314cdca1647f15d7844ba1d8.css b/public/book.min.f0844eb1b9e55a1aa15f4c4d9f6cb2aed7ea3d74314cdca1647f15d7844ba1d8.css
new file mode 100644
index 0000000..f4e8e13
--- /dev/null
+++ b/public/book.min.f0844eb1b9e55a1aa15f4c4d9f6cb2aed7ea3d74314cdca1647f15d7844ba1d8.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}a:link{color:blue}a:visited{color:purple}a:hover{color:orange}a:focus{color:green}a:active{color:red}
\ No newline at end of file
diff --git a/public/book.min.f2da846ba9519b6a846b25fd020cbe9e2381d8ad83405398926710832ec4cd03.css b/public/book.min.f2da846ba9519b6a846b25fd020cbe9e2381d8ad83405398926710832ec4cd03.css
new file mode 100644
index 0000000..dee18a0
--- /dev/null
+++ b/public/book.min.f2da846ba9519b6a846b25fd020cbe9e2381d8ad83405398926710832ec4cd03.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:40% 60%}.grid-item{height:1.6rem}
\ No newline at end of file
diff --git a/public/book.min.f356260cd2018e7a47c8ccef1b94bf6163837f7a78f7ac216d84f4aad582c273.css b/public/book.min.f356260cd2018e7a47c8ccef1b94bf6163837f7a78f7ac216d84f4aad582c273.css
new file mode 100644
index 0000000..7050fbb
--- /dev/null
+++ b/public/book.min.f356260cd2018e7a47c8ccef1b94bf6163837f7a78f7ac216d84f4aad582c273.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}.markdown table{border:none}td{width:30%}.markdown table tr td{padding:2rem 1rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.f4d31c2d5be8d50501be2328c698193fe04941af6a3419d9fbcdfc964278fbb3.css b/public/book.min.f4d31c2d5be8d50501be2328c698193fe04941af6a3419d9fbcdfc964278fbb3.css
new file mode 100644
index 0000000..7dbb8ed
--- /dev/null
+++ b/public/book.min.f4d31c2d5be8d50501be2328c698193fe04941af6a3419d9fbcdfc964278fbb3.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1.2em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a:visited{color:#000}table{border-spacing:500px}td{width:30%}.markdown table tr td{padding:5rem}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.f7f8e1820da58a1734a943e7dd04bbc1c7e333ad0f64c36fde411a29c5fe6997.css b/public/book.min.f7f8e1820da58a1734a943e7dd04bbc1c7e333ad0f64c36fde411a29c5fe6997.css
new file mode 100644
index 0000000..f7f481a
--- /dev/null
+++ b/public/book.min.f7f8e1820da58a1734a943e7dd04bbc1c7e333ad0f64c36fde411a29c5fe6997.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{color:#000}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/book.min.fbbf1a6fbe7d24be4f07633b9a257bc9272599fdd6ecfae80245e666a57c7b54.css b/public/book.min.fbbf1a6fbe7d24be4f07633b9a257bc9272599fdd6ecfae80245e666a57c7b54.css
new file mode 100644
index 0000000..7d91014
--- /dev/null
+++ b/public/book.min.fbbf1a6fbe7d24be4f07633b9a257bc9272599fdd6ecfae80245e666a57c7b54.css
@@ -0,0 +1 @@
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.ref-subheader{text-decoration:none}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 5rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}
\ No newline at end of file
diff --git a/public/categories/index.html b/public/categories/index.html
index d098cb0..16515d0 100644
--- a/public/categories/index.html
+++ b/public/categories/index.html
@@ -15,9 +15,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/categories/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <link rel="alternate" type="application/rss+xml" href="http://localhost:1313/categories/index.xml" title="p5.fab" />
 <!--
 Made with Book Theme
@@ -102,41 +102,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -148,24 +114,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -174,7 +127,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -185,19 +138,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/index.html b/public/docs/index.html
index 8575047..8fff331 100644
--- a/public/docs/index.html
+++ b/public/docs/index.html
@@ -15,9 +15,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.24ef9fafae4cf9e4f1ceca358b3072f0892f80671d367823439c4966b256043b.js" integrity="sha256-JO&#43;fr65M&#43;eTxzso1izBy8IkvgGcdNngjQ5xJZrJWBDs=" crossorigin="anonymous"></script>
 <link rel="alternate" type="application/rss+xml" href="http://localhost:1313/docs/index.xml" title="p5.fab" />
 <!--
 Made with Book Theme
@@ -102,54 +102,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
-  
+  </ul>
 
         </li>
       
@@ -161,43 +114,17 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
   </ul>
 
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/index.xml b/public/docs/index.xml
index 07a6679..d05bbd3 100644
--- a/public/docs/index.xml
+++ b/public/docs/index.xml
@@ -21,12 +21,5 @@
       <guid>http://localhost:1313/docs/machine-compatibility/</guid>
       <description>Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We&amp;rsquo;ve tested p5.fab on the following machines:&#xA;Machine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill).</description>
     </item>
-    <item>
-      <title></title>
-      <link>http://localhost:1313/docs/reference/</link>
-      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/reference/</guid>
-      <description>Reference # Fab # A class to describe a fabrication machine.&#xA;A fab object represents a 3D printer. It is comprised of the following information:&#xA;workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])&#xA;Parameters # config: a json object specifying requisite machine information autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).</description>
-    </item>
   </channel>
 </rss>
diff --git a/public/docs/machine-compatibility/index.html b/public/docs/machine-compatibility/index.html
index 47cb883..6550059 100644
--- a/public/docs/machine-compatibility/index.html
+++ b/public/docs/machine-compatibility/index.html
@@ -19,9 +19,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/machine-compatibility/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -105,41 +105,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -151,24 +117,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -177,7 +130,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -188,19 +141,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/quickstart/index.html b/public/docs/quickstart/index.html
index ef16e8f..fde374d 100644
--- a/public/docs/quickstart/index.html
+++ b/public/docs/quickstart/index.html
@@ -19,9 +19,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/quickstart/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.c52da93774ced0b779087bc46b608b93aa09fc490e972f1da53c931c95275982.js" integrity="sha256-xS2pN3TO0Ld5CHvEa2CLk6oJ/EkOly8dpTyTHJUnWYI=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -105,54 +105,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
-  
+  </ul>
 
         </li>
       
@@ -164,43 +117,17 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
   </ul>
 
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/reference-pages/autohome/index.html b/public/docs/reference-pages/autohome/index.html
new file mode 100644
index 0000000..19748c3
--- /dev/null
+++ b/public/docs/reference-pages/autohome/index.html
@@ -0,0 +1,572 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).
+Syntax # fab.autoHome()
+Parameters # None">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Autohome" />
+<meta property="og:description" content="autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).
+Syntax # fab.autoHome()
+Parameters # None" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/autohome/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Autohome | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/autohome/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="active">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Autohome</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#autohome">autoHome</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="autohome">
+  autoHome
+  <a class="anchor" href="#autohome">#</a>
+</h2>
+<p>Autohome the machine (with a <code>G28</code> command) and zero the extruder position (with a <code>G92 E0</code> command).</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.autoHome()</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<p>None</p>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#autohome">autoHome</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/fab/index.html b/public/docs/reference-pages/fab/index.html
new file mode 100644
index 0000000..94ea7aa
--- /dev/null
+++ b/public/docs/reference-pages/fab/index.html
@@ -0,0 +1,583 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" Fab # A class to describe a fabrication machine.
+A fab object represents a 3D printer. It is comprised of the following information:
+workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])
+Parameters # config: a json object specifying requisite machine information ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Fab" />
+<meta property="og:description" content=" Fab # A class to describe a fabrication machine.
+A fab object represents a 3D printer. It is comprised of the following information:
+workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])
+Parameters # config: a json object specifying requisite machine information " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/fab/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Fab | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/fab/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="active">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Fab</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#fab">Fab</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="fab">
+  Fab
+  <a class="anchor" href="#fab">#</a>
+</h2>
+<p>A class to describe a fabrication machine.</p>
+<p>A <code>fab</code> object represents a 3D printer. It is comprised of the following information:</p>
+<ul>
+<li><code>workEnvelope</code>: maximum X, Y, and Z dimensions of the machine</li>
+<li><code>nozzleDiameter</code>: Diameter of the nozzle in mm</li>
+<li><code>filamentDiameter</code>: Diameter of filament in mm</li>
+<li><code>name</code>: a human readable string to identify this machine</li>
+</ul>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab([config])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>config: a json object specifying requisite machine information</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#fab">Fab</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/move/index.html b/public/docs/reference-pages/move/index.html
new file mode 100644
index 0000000..020a506
--- /dev/null
+++ b/public/docs/reference-pages/move/index.html
@@ -0,0 +1,577 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" move # Move relative to the current position without extruding material.
+Syntax # fab.move(dx, dy, dz, [velocity])
+Parameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move" />
+<meta property="og:description" content=" move # Move relative to the current position without extruding material.
+Syntax # fab.move(dx, dy, dz, [velocity])
+Parameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/move/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/move/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="active">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#move">move</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="move">
+  move
+  <a class="anchor" href="#move">#</a>
+</h2>
+<p>Move relative to the current position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.move(dx, dy, dz, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>dx: Number, the relative x distance to move (in current units, mm by default)</li>
+<li>dy: Number, the relative y distance to move (in current units, mm by default)</li>
+<li>dz: Number, the relative z distance to move (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#move">move</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movee/index.html b/public/docs/reference-pages/movee/index.html
new file mode 100644
index 0000000..6e48ea5
--- /dev/null
+++ b/public/docs/reference-pages/movee/index.html
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveE # Move in E relative to the current position.
+Syntax # fab.moveE(de, [velocity])
+Parameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="moveE" />
+<meta property="og:description" content=" moveE # Move in E relative to the current position.
+Syntax # fab.moveE(de, [velocity])
+Parameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movee/" /><meta property="article:section" content="docs" />
+
+
+
+<title>moveE | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movee/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="active">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>moveE</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movee">moveE</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movee">
+  moveE
+  <a class="anchor" href="#movee">#</a>
+</h2>
+<p>Move in E relative to the current position.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveE(de, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>de: Number, the relative e distance to move (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movee">moveE</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/moveextrude/index.html b/public/docs/reference-pages/moveextrude/index.html
new file mode 100644
index 0000000..0b33230
--- /dev/null
+++ b/public/docs/reference-pages/moveextrude/index.html
@@ -0,0 +1,580 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.
+Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])
+Parameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move Extrude" />
+<meta property="og:description" content="moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.
+Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])
+Parameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/moveextrude/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move Extrude | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/moveextrude/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="active">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move Extrude</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#moveextrude">moveExtrude</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="moveextrude">
+  moveExtrude
+  <a class="anchor" href="#moveextrude">#</a>
+</h2>
+<p>Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>x: Number, the x position to move to (in current units, mm by default)</li>
+<li>y: Number, the y position to move to (in current units, mm by default)</li>
+<li>z: Number, the z position to move to (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+<li>extrusion:  Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of <code>[multiplication]</code> parameter</li>
+<li>multiplication: Boolean, optional. If true, <code>extrusion</code> value is used as a multiplication modifier to default extrusion calculation. If fase, <code>extrusion</code> value is used a total amount of filament to deposit in mm. False by default.</li>
+</ul>
+<hr>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#moveextrude">moveExtrude</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/moveto/index.html b/public/docs/reference-pages/moveto/index.html
new file mode 100644
index 0000000..f545c08
--- /dev/null
+++ b/public/docs/reference-pages/moveto/index.html
@@ -0,0 +1,577 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveTo # Move directly to an absolute (x,y,z) position without extruding material.
+Syntax # fab.moveTo(x, y, z, [velocity])
+Parameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To" />
+<meta property="og:description" content=" moveTo # Move directly to an absolute (x,y,z) position without extruding material.
+Syntax # fab.moveTo(x, y, z, [velocity])
+Parameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/moveto/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/moveto/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="active">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#moveto">moveTo</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="moveto">
+  moveTo
+  <a class="anchor" href="#moveto">#</a>
+</h2>
+<p>Move directly to an absolute (x,y,z) position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveTo(x, y, z, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>x: Number, the x position to move to (in current units, mm by default)</li>
+<li>y: Number, the y position to move to (in current units, mm by default)</li>
+<li>z: Number, the z position to move to (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#moveto">moveTo</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movetoe/index.html b/public/docs/reference-pages/movetoe/index.html
new file mode 100644
index 0000000..38ddb5e
--- /dev/null
+++ b/public/docs/reference-pages/movetoe/index.html
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveToE # Move directly to an absolute E position.
+Syntax # fab.moveToE(e, [velocity])
+Parameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To E" />
+<meta property="og:description" content=" moveToE # Move directly to an absolute E position.
+Syntax # fab.moveToE(e, [velocity])
+Parameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movetoe/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To E | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movetoe/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="active">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To E</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetoe">moveToE</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movetoe">
+  moveToE
+  <a class="anchor" href="#movetoe">#</a>
+</h2>
+<p>Move directly to an absolute E position.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveToE(e, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>e: Number, the e position to move to (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetoe">moveToE</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movetox/index.html b/public/docs/reference-pages/movetox/index.html
new file mode 100644
index 0000000..e2d79d1
--- /dev/null
+++ b/public/docs/reference-pages/movetox/index.html
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveToX # Move directly to an absolute X position without extruding material.
+Syntax # fab.moveToX(x, [velocity])
+Parameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To X" />
+<meta property="og:description" content=" moveToX # Move directly to an absolute X position without extruding material.
+Syntax # fab.moveToX(x, [velocity])
+Parameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movetox/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To X | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movetox/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="active">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To X</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetox">moveToX</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movetox">
+  moveToX
+  <a class="anchor" href="#movetox">#</a>
+</h2>
+<p>Move directly to an absolute X position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveToX(x, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>x: Number, the x position to move to (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetox">moveToX</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movetoy/index.html b/public/docs/reference-pages/movetoy/index.html
new file mode 100644
index 0000000..4326169
--- /dev/null
+++ b/public/docs/reference-pages/movetoy/index.html
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveToY # Move directly to an absolute Y position without extruding material.
+Syntax # fab.moveToY(y, [velocity])
+Parameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To Y" />
+<meta property="og:description" content=" moveToY # Move directly to an absolute Y position without extruding material.
+Syntax # fab.moveToY(y, [velocity])
+Parameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movetoy/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To Y | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movetoy/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="active">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To Y</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetoy">moveToY</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movetoy">
+  moveToY
+  <a class="anchor" href="#movetoy">#</a>
+</h2>
+<p>Move directly to an absolute Y position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveToY(y, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>y: Number, the y position to move to (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetoy">moveToY</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movetoz/index.html b/public/docs/reference-pages/movetoz/index.html
new file mode 100644
index 0000000..56db9a4
--- /dev/null
+++ b/public/docs/reference-pages/movetoz/index.html
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveToZ # Move directly to an absolute Z position without extruding material.
+Syntax # fab.moveToZ(z, [velocity])
+Parameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="MoveToZ" />
+<meta property="og:description" content=" moveToZ # Move directly to an absolute Z position without extruding material.
+Syntax # fab.moveToZ(z, [velocity])
+Parameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movetoz/" /><meta property="article:section" content="docs" />
+
+
+
+<title>MoveToZ | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movetoz/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="active">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>MoveToZ</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetoz">moveToZ</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movetoz">
+  moveToZ
+  <a class="anchor" href="#movetoz">#</a>
+</h2>
+<p>Move directly to an absolute Z position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveToZ(z, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>z: Number, the z position to move to (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movetoz">moveToZ</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movex/index.html b/public/docs/reference-pages/movex/index.html
new file mode 100644
index 0000000..a5aa484
--- /dev/null
+++ b/public/docs/reference-pages/movex/index.html
@@ -0,0 +1,586 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveX # Move in X relative to the current position without extruding material.
+Syntax # fab.moveX(dx, [velocity])
+Parameters # dx: Number, the relative x distance to move (in current units, mm by default)
+v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
+dx: Number, the relative x distance to move (in current units, mm by default)">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To X" />
+<meta property="og:description" content="moveX # Move in X relative to the current position without extruding material.
+Syntax # fab.moveX(dx, [velocity])
+Parameters # dx: Number, the relative x distance to move (in current units, mm by default)
+v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)
+dx: Number, the relative x distance to move (in current units, mm by default)" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movex/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To X | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movex/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="active">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To X</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movex">moveX</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movex">
+  moveX
+  <a class="anchor" href="#movex">#</a>
+</h2>
+<p>Move in X relative to the current position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveX(dx, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>
+<p>dx: Number, the relative x distance to move (in current units, mm by default)</p>
+</li>
+<li>
+<p>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</p>
+</li>
+<li>
+<p>dx: Number, the relative x distance to move (in current units, mm by default)</p>
+</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movex">moveX</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movey/index.html b/public/docs/reference-pages/movey/index.html
new file mode 100644
index 0000000..64b7f7c
--- /dev/null
+++ b/public/docs/reference-pages/movey/index.html
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveY # Move in Y relative to the current position without extruding material.
+Syntax # fab.moveY(dy, [velocity])
+Parameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move Y" />
+<meta property="og:description" content=" moveY # Move in Y relative to the current position without extruding material.
+Syntax # fab.moveY(dy, [velocity])
+Parameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movey/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move Y | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movey/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="active">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move Y</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movey">moveY</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movey">
+  moveY
+  <a class="anchor" href="#movey">#</a>
+</h2>
+<p>Move in Y relative to the current position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveY(dy, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>dy: Number, the relative y distance to move (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movey">moveY</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/movez/index.html b/public/docs/reference-pages/movez/index.html
new file mode 100644
index 0000000..8eea186
--- /dev/null
+++ b/public/docs/reference-pages/movez/index.html
@@ -0,0 +1,575 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" moveZ # Move in Z relative to the current position without extruding material.
+Syntax # fab.moveZ(dz, [velocity])
+Parameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="MoveZ" />
+<meta property="og:description" content=" moveZ # Move in Z relative to the current position without extruding material.
+Syntax # fab.moveZ(dz, [velocity])
+Parameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/movez/" /><meta property="article:section" content="docs" />
+
+
+
+<title>MoveZ | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/movez/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="active">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>MoveZ</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movez">moveZ</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="movez">
+  moveZ
+  <a class="anchor" href="#movez">#</a>
+</h2>
+<p>Move in Z relative to the current position without extruding material.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.moveZ(dz, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>dz: Number, the relative z distance to move (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#movez">moveZ</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/setbedt/index.html b/public/docs/reference-pages/setbedt/index.html
new file mode 100644
index 0000000..8776c6c
--- /dev/null
+++ b/public/docs/reference-pages/setbedt/index.html
@@ -0,0 +1,531 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="" />
+<meta property="og:description" content="" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/setbedt/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Bed T | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/setbedt/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Bed T</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents"></nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents"></nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/setnozzlet/index.html b/public/docs/reference-pages/setnozzlet/index.html
new file mode 100644
index 0000000..4014ffb
--- /dev/null
+++ b/public/docs/reference-pages/setnozzlet/index.html
@@ -0,0 +1,578 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setNozzleT # Set the printer&rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.
+Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setNozzleT(temperature, [wait])
+Parameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set Nozzle Temp" />
+<meta property="og:description" content="setNozzleT # Set the printer&rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.
+Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setNozzleT(temperature, [wait])
+Parameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/setnozzlet/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Nozzle Temp | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/setnozzlet/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="active">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Nozzle Temp</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#setnozzlet">setNozzleT</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="setnozzlet">
+  setNozzleT
+  <a class="anchor" href="#setnozzlet">#</a>
+</h2>
+<p>Set the printer&rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.</p>
+<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.setNozzleT(temperature, [wait])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>temperature: Number, the temperature to heat the nozzle to in degrees Celcius</li>
+<li>wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#setnozzlet">setNozzleT</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/settemps/index.html b/public/docs/reference-pages/settemps/index.html
new file mode 100644
index 0000000..1c3b10b
--- /dev/null
+++ b/public/docs/reference-pages/settemps/index.html
@@ -0,0 +1,579 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.
+Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])
+Parameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set Temps" />
+<meta property="og:description" content="setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.
+Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])
+Parameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/settemps/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Temps | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/settemps/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="active">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Temps</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#settemps">setTemps</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="settemps">
+  setTemps
+  <a class="anchor" href="#settemps">#</a>
+</h2>
+<p>Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.</p>
+<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.setTemps(nozzleTemperature, bedTemperature, [wait])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius</li>
+<li>bedTemperature: Number, the temperature to heat the bed to in degrees Celcius</li>
+<li>wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#settemps">setTemps</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference-pages/travelto/index.html b/public/docs/reference-pages/travelto/index.html
new file mode 100644
index 0000000..398a6da
--- /dev/null
+++ b/public/docs/reference-pages/travelto/index.html
@@ -0,0 +1,580 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.
+The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.
+Syntax # fab.travelTo(x, y, z, [velocity])
+Parameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Travel To" />
+<meta property="og:description" content=" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.
+The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.
+Syntax # fab.travelTo(x, y, z, [velocity])
+Parameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference-pages/travelto/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Travel To | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference-pages/travelto/">
+<link rel="stylesheet" href="/book.min.ed844daee52bfdc0ced235079233b05563cb53d5eebead6612ad009c9a4a3192.css" integrity="sha256-7YRNruUr/cDO0jUHkjOwVWPLU9Xuvq1mEq0AnJpKMZI=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js" integrity="sha256-doS2PazoJflvJxpg18xUVyTAO09Cz8EP&#43;NveGWAJDbE=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/fab/" class="">Fab</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/move/" class="">Move</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveextrude/" class="">Move Extrude</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/moveto/" class="">Move To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoe/" class="">Move To E</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetox/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movex/" class="">Move To X</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoy/" class="">Move To Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movey/" class="">Move Y</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movee/" class="">moveE</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movetoz/" class="">MoveToZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/movez/" class="">MoveZ</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/setnozzlet/" class="">Set Nozzle Temp</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/settemps/" class="">Set Temps</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/travelto/" class="active">Travel To</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+        </li>
+      
+    
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference-pages/autohome/" class="">Autohome</a>
+  
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Travel To</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#travelto">travelTo</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="travelto">
+  travelTo
+  <a class="anchor" href="#travelto">#</a>
+</h2>
+<p>Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.</p>
+<p>The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab.travelTo(x, y, z, [velocity])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>x: Number, the x position to move to (in current units, mm by default)</li>
+<li>y: Number, the y position to move to (in current units, mm by default)</li>
+<li>z: Number, the z position to move to (in current units, mm by default)</li>
+<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#travelto">travelTo</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/index.html b/public/docs/reference/index.html
index fbcc687..b1b757e 100644
--- a/public/docs/reference/index.html
+++ b/public/docs/reference/index.html
@@ -3,29 +3,31 @@
 <head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
   <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<meta name="description" content="Reference # Fab # A class to describe a fabrication machine.
-A fab object represents a 3D printer. It is comprised of the following information:
-workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])
-Parameters # config: a json object specifying requisite machine information autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).">
+<meta name="description" content="Reference # Fab # Path Commands # moveTo()
+Move to a point. moveToX()
+Move to an X position. moveToY()
+Move to a Y position. moveToZ()
+Move to a Z position. moveToE()
+Move to a E position. move()
+Move relative to current position in x, y, and z. moveX()
+Move relative to current position in X. moveY()
+Move relative to current position in Y. moveZ()
+Move relative to current position in Z.">
 <meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
 <meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
 <meta name="color-scheme" content="light dark"><meta property="og:title" content="" />
-<meta property="og:description" content="Reference # Fab # A class to describe a fabrication machine.
-A fab object represents a 3D printer. It is comprised of the following information:
-workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])
-Parameters # config: a json object specifying requisite machine information autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command)." />
-<meta property="og:type" content="article" />
-<meta property="og:url" content="http://localhost:1313/docs/reference/" /><meta property="article:section" content="docs" />
-
-
+<meta property="og:description" content="" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/" />
 
 <title>Reference | p5.fab</title>
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/reference/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<link rel="alternate" type="application/rss+xml" href="http://localhost:1313/docs/reference/index.xml" title="p5.fab" />
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -109,54 +111,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
-  
+  </ul>
 
         </li>
       
@@ -168,43 +123,17 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
+    <a href="/docs/reference/" class="active">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
   </ul>
 
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="active">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
@@ -257,106 +186,10 @@ <h2 class="book-brand">
   
 <nav id="TableOfContents">
   <ul>
-    <li><a href="#fab">Fab</a>
-      <ul>
-        <li><a href="#syntax">Syntax</a></li>
-        <li><a href="#parameters">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#autohome">autoHome</a>
-      <ul>
-        <li><a href="#syntax-1">Syntax</a></li>
-        <li><a href="#parameters-1">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#setnozzlet">setNozzleT</a>
-      <ul>
-        <li><a href="#syntax-2">Syntax</a></li>
-        <li><a href="#parameters-2">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#setbedt">setBedT</a>
-      <ul>
-        <li><a href="#syntax-3">Syntax</a></li>
-        <li><a href="#parameters-3">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#settemps">setTemps</a>
-      <ul>
-        <li><a href="#syntax-4">Syntax</a></li>
-        <li><a href="#parameters-4">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#moveto">moveTo</a>
-      <ul>
-        <li><a href="#syntax-5">Syntax</a></li>
-        <li><a href="#parameters-5">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetox">moveToX</a>
-      <ul>
-        <li><a href="#syntax-6">Syntax</a></li>
-        <li><a href="#parameters-6">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetoy">moveToY</a>
-      <ul>
-        <li><a href="#syntax-7">Syntax</a></li>
-        <li><a href="#parameters-7">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetoz">moveToZ</a>
-      <ul>
-        <li><a href="#syntax-8">Syntax</a></li>
-        <li><a href="#parameters-8">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetoe">moveToE</a>
-      <ul>
-        <li><a href="#syntax-9">Syntax</a></li>
-        <li><a href="#parameters-9">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#move">move</a>
-      <ul>
-        <li><a href="#syntax-10">Syntax</a></li>
-        <li><a href="#parameters-10">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movex">moveX</a>
-      <ul>
-        <li><a href="#syntax-11">Syntax</a></li>
-        <li><a href="#parameters-11">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movey">moveY</a>
-      <ul>
-        <li><a href="#syntax-12">Syntax</a></li>
-        <li><a href="#parameters-12">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movez">moveZ</a>
-      <ul>
-        <li><a href="#syntax-13">Syntax</a></li>
-        <li><a href="#parameters-13">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movee">moveE</a>
+    <li><a href="#a-hrefreference-pagesfabfaba"><a href="reference-pages/fab">Fab</a></a>
       <ul>
-        <li><a href="#syntax-14">Syntax</a></li>
-        <li><a href="#parameters-14">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#travelto">travelTo</a>
-      <ul>
-        <li><a href="#syntax-15">Syntax</a></li>
-        <li><a href="#parameters-15">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#moveextrude">moveExtrude</a>
-      <ul>
-        <li><a href="#syntax-16">Syntax</a></li>
-        <li><a href="#parameters-16">Parameters</a></li>
+        <li><a href="#path-commands">Path Commands</a></li>
+        <li><a href="#g--m-codes">G &amp; M Codes</a></li>
       </ul>
     </li>
   </ul>
@@ -375,353 +208,133 @@ <h2 class="book-brand">
   Reference
   <a class="anchor" href="#reference">#</a>
 </h1>
-<h2 id="fab">
-  Fab
-  <a class="anchor" href="#fab">#</a>
+<h2 id="a-hrefreference-pagesfabfaba">
+  <a href="reference-pages/fab">Fab</a>
+  <a class="anchor" href="#a-hrefreference-pagesfabfaba">#</a>
 </h2>
-<p>A class to describe a fabrication machine.</p>
-<p>A <code>fab</code> object represents a 3D printer. It is comprised of the following information:</p>
-<ul>
-<li><code>workEnvelope</code>: maximum X, Y, and Z dimensions of the machine</li>
-<li><code>nozzleDiameter</code>: Diameter of the nozzle in mm</li>
-<li><code>filamentDiameter</code>: Diameter of filament in mm</li>
-<li><code>name</code>: a human readable string to identify this machine</li>
-</ul>
-<h3 id="syntax">
-  Syntax
-  <a class="anchor" href="#syntax">#</a>
-</h3>
-<p><code>fab([config])</code></p>
-<h3 id="parameters">
-  Parameters
-  <a class="anchor" href="#parameters">#</a>
-</h3>
-<ul>
-<li>config: a json object specifying requisite machine information</li>
-</ul>
-<hr>
-<h2 id="autohome">
-  autoHome
-  <a class="anchor" href="#autohome">#</a>
-</h2>
-<p>Autohome the machine (with a <code>G28</code> command) and zero the extruder position (with a <code>G92 E0</code> command).</p>
-<h3 id="syntax-1">
-  Syntax
-  <a class="anchor" href="#syntax-1">#</a>
-</h3>
-<p><code>fab.autoHome()</code></p>
-<h3 id="parameters-1">
-  Parameters
-  <a class="anchor" href="#parameters-1">#</a>
-</h3>
-<p>None</p>
-<hr>
-<h2 id="setnozzlet">
-  setNozzleT
-  <a class="anchor" href="#setnozzlet">#</a>
-</h2>
-<p>Set the printer&rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.</p>
-<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
-<h3 id="syntax-2">
-  Syntax
-  <a class="anchor" href="#syntax-2">#</a>
-</h3>
-<p><code>fab.setNozzleT(temperature, [wait])</code></p>
-<h3 id="parameters-2">
-  Parameters
-  <a class="anchor" href="#parameters-2">#</a>
-</h3>
-<ul>
-<li>temperature: Number, the temperature to heat the nozzle to in degrees Celcius</li>
-<li>wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.</li>
-</ul>
-<hr>
-<h2 id="setbedt">
-  setBedT
-  <a class="anchor" href="#setbedt">#</a>
-</h2>
-<p>Set the printer&rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.</p>
-<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
-<h3 id="syntax-3">
-  Syntax
-  <a class="anchor" href="#syntax-3">#</a>
-</h3>
-<p><code>fab.setNozzleT(temperature, [wait])</code></p>
-<h3 id="parameters-3">
-  Parameters
-  <a class="anchor" href="#parameters-3">#</a>
-</h3>
-<ul>
-<li>temperature: Number, the temperature to heat the bed to in degrees Celcius</li>
-<li>wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.</li>
-</ul>
-<hr>
-<h2 id="settemps">
-  setTemps
-  <a class="anchor" href="#settemps">#</a>
-</h2>
-<p>Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.</p>
-<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
-<h3 id="syntax-4">
-  Syntax
-  <a class="anchor" href="#syntax-4">#</a>
-</h3>
-<p><code>fab.setTemps(nozzleTemperature, bedTemperature, [wait])</code></p>
-<h3 id="parameters-4">
-  Parameters
-  <a class="anchor" href="#parameters-4">#</a>
-</h3>
-<ul>
-<li>nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius</li>
-<li>bedTemperature: Number, the temperature to heat the bed to in degrees Celcius</li>
-<li>wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.</li>
-</ul>
-<hr>
-<h2 id="moveto">
-  moveTo
-  <a class="anchor" href="#moveto">#</a>
-</h2>
-<p>Move directly to an absolute (x,y,z) position without extruding material.</p>
-<h3 id="syntax-5">
-  Syntax
-  <a class="anchor" href="#syntax-5">#</a>
-</h3>
-<p><code>fab.moveTo(x, y, z, [velocity])</code></p>
-<h3 id="parameters-5">
-  Parameters
-  <a class="anchor" href="#parameters-5">#</a>
-</h3>
-<ul>
-<li>x: Number, the x position to move to (in current units, mm by default)</li>
-<li>y: Number, the y position to move to (in current units, mm by default)</li>
-<li>z: Number, the z position to move to (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="movetox">
-  moveToX
-  <a class="anchor" href="#movetox">#</a>
-</h2>
-<p>Move directly to an absolute X position without extruding material.</p>
-<h3 id="syntax-6">
-  Syntax
-  <a class="anchor" href="#syntax-6">#</a>
-</h3>
-<p><code>fab.moveToX(x, [velocity])</code></p>
-<h3 id="parameters-6">
-  Parameters
-  <a class="anchor" href="#parameters-6">#</a>
-</h3>
-<ul>
-<li>x: Number, the x position to move to (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="movetoy">
-  moveToY
-  <a class="anchor" href="#movetoy">#</a>
-</h2>
-<p>Move directly to an absolute Y position without extruding material.</p>
-<h3 id="syntax-7">
-  Syntax
-  <a class="anchor" href="#syntax-7">#</a>
-</h3>
-<p><code>fab.moveToY(y, [velocity])</code></p>
-<h3 id="parameters-7">
-  Parameters
-  <a class="anchor" href="#parameters-7">#</a>
-</h3>
-<ul>
-<li>y: Number, the y position to move to (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="movetoz">
-  moveToZ
-  <a class="anchor" href="#movetoz">#</a>
-</h2>
-<p>Move directly to an absolute Z position without extruding material.</p>
-<h3 id="syntax-8">
-  Syntax
-  <a class="anchor" href="#syntax-8">#</a>
-</h3>
-<p><code>fab.moveToZ(z, [velocity])</code></p>
-<h3 id="parameters-8">
-  Parameters
-  <a class="anchor" href="#parameters-8">#</a>
-</h3>
-<ul>
-<li>z: Number, the z position to move to (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="movetoe">
-  moveToE
-  <a class="anchor" href="#movetoe">#</a>
-</h2>
-<p>Move directly to an absolute E position.</p>
-<h3 id="syntax-9">
-  Syntax
-  <a class="anchor" href="#syntax-9">#</a>
-</h3>
-<p><code>fab.moveToE(e, [velocity])</code></p>
-<h3 id="parameters-9">
-  Parameters
-  <a class="anchor" href="#parameters-9">#</a>
-</h3>
-<ul>
-<li>e: Number, the e position to move to (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="move">
-  move
-  <a class="anchor" href="#move">#</a>
-</h2>
-<p>Move relative to the current position without extruding material.</p>
-<h3 id="syntax-10">
-  Syntax
-  <a class="anchor" href="#syntax-10">#</a>
-</h3>
-<p><code>fab.move(dx, dy, dz, [velocity])</code></p>
-<h3 id="parameters-10">
-  Parameters
-  <a class="anchor" href="#parameters-10">#</a>
-</h3>
-<ul>
-<li>dx: Number, the relative x distance to move (in current units, mm by default)</li>
-<li>dy: Number, the relative y distance to move (in current units, mm by default)</li>
-<li>dz: Number, the relative z distance to move (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="movex">
-  moveX
-  <a class="anchor" href="#movex">#</a>
-</h2>
-<p>Move in X relative to the current position without extruding material.</p>
-<h3 id="syntax-11">
-  Syntax
-  <a class="anchor" href="#syntax-11">#</a>
-</h3>
-<p><code>fab.moveX(dx, [velocity])</code></p>
-<h3 id="parameters-11">
-  Parameters
-  <a class="anchor" href="#parameters-11">#</a>
-</h3>
-<ul>
-<li>
-<p>dx: Number, the relative x distance to move (in current units, mm by default)</p>
-</li>
-<li>
-<p>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</p>
-</li>
-<li>
-<p>dx: Number, the relative x distance to move (in current units, mm by default)</p>
-</li>
-</ul>
-<h2 id="movey">
-  moveY
-  <a class="anchor" href="#movey">#</a>
-</h2>
-<p>Move in Y relative to the current position without extruding material.</p>
-<h3 id="syntax-12">
-  Syntax
-  <a class="anchor" href="#syntax-12">#</a>
-</h3>
-<p><code>fab.moveY(dy, [velocity])</code></p>
-<h3 id="parameters-12">
-  Parameters
-  <a class="anchor" href="#parameters-12">#</a>
-</h3>
-<ul>
-<li>dy: Number, the relative y distance to move (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="movez">
-  moveZ
-  <a class="anchor" href="#movez">#</a>
-</h2>
-<p>Move in Z relative to the current position without extruding material.</p>
-<h3 id="syntax-13">
-  Syntax
-  <a class="anchor" href="#syntax-13">#</a>
-</h3>
-<p><code>fab.moveZ(dz, [velocity])</code></p>
-<h3 id="parameters-13">
-  Parameters
-  <a class="anchor" href="#parameters-13">#</a>
-</h3>
-<ul>
-<li>dz: Number, the relative z distance to move (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="movee">
-  moveE
-  <a class="anchor" href="#movee">#</a>
-</h2>
-<p>Move in E relative to the current position.</p>
-<h3 id="syntax-14">
-  Syntax
-  <a class="anchor" href="#syntax-14">#</a>
-</h3>
-<p><code>fab.moveE(de, [velocity])</code></p>
-<h3 id="parameters-14">
-  Parameters
-  <a class="anchor" href="#parameters-14">#</a>
-</h3>
-<ul>
-<li>de: Number, the relative e distance to move (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="travelto">
-  travelTo
-  <a class="anchor" href="#travelto">#</a>
-</h2>
-<p>Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.</p>
-<p>The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.</p>
-<h3 id="syntax-15">
-  Syntax
-  <a class="anchor" href="#syntax-15">#</a>
-</h3>
-<p><code>fab.travelTo(x, y, z, [velocity])</code></p>
-<h3 id="parameters-15">
-  Parameters
-  <a class="anchor" href="#parameters-15">#</a>
-</h3>
-<ul>
-<li>x: Number, the x position to move to (in current units, mm by default)</li>
-<li>y: Number, the y position to move to (in current units, mm by default)</li>
-<li>z: Number, the z position to move to (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-</ul>
-<hr>
-<h2 id="moveextrude">
-  moveExtrude
-  <a class="anchor" href="#moveextrude">#</a>
-</h2>
-<p>Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.</p>
-<h3 id="syntax-16">
-  Syntax
-  <a class="anchor" href="#syntax-16">#</a>
-</h3>
-<p><code>fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])</code></p>
-<h3 id="parameters-16">
-  Parameters
-  <a class="anchor" href="#parameters-16">#</a>
-</h3>
-<ul>
-<li>x: Number, the x position to move to (in current units, mm by default)</li>
-<li>y: Number, the y position to move to (in current units, mm by default)</li>
-<li>z: Number, the z position to move to (in current units, mm by default)</li>
-<li>v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</li>
-<li>extrusion:  Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of <code>[multiplication]</code> parameter</li>
-<li>multiplication: Boolean, optional. If true, <code>extrusion</code> value is used as a multiplication modifier to default extrusion calculation. If fase, <code>extrusion</code> value is used a total amount of filament to deposit in mm. False by default.</li>
-</ul>
-<hr>
+<!-- template for adding new doc items  -->
+<!--
+<tr>
+    <td>
+
+    </td>
+    <td>
+    
+    </td>
+    <td>
+    
+    </td>
+</tr>
+-->
+<h3 id="path-commands">
+  Path Commands
+  <a class="anchor" href="#path-commands">#</a>
+</h3>
+<table>
+  <tbody>
+    <tr>
+      <td>
+        <a href="reference-pages/moveTo" class="ref-item">moveTo()</a><br>
+        <span class="ref-info">Move to a point.</span>  
+      </td>
+      <td>
+        <a href="reference-pages/moveToX" class="ref-item">moveToX()</a><br>
+        <span class="ref-info">Move to an X position.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveToY" class="ref-item">moveToY()</a><br>
+        <span class="ref-info">Move to a Y position.</span>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a href="reference-pages/moveToZ" class="ref-item">moveToZ()</a><br>
+        <span class="ref-info">Move to a Z position.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveToE" class="ref-item">moveToE()</a><br>
+        <span class="ref-info">Move to a E position.</span> 
+      </td>
+      <td>
+        <a href="reference-pages/move" class="ref-item">move()</a><br>
+        <span class="ref-info">Move relative to current position in x, y, and z.</span>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a href="reference-pages/moveX" class="ref-item">moveX()</a><br>
+        <span class="ref-info">Move relative to current position in X.</span></td>
+      <td>
+        <a href="reference-pages/moveY" class="ref-item">moveY()</a><br>
+        <span class="ref-info">Move relative to current position in Y.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveZ" class="ref-item">moveZ()</a><br>
+        <span class="ref-info">Move relative to current position in Z.</span>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a href="reference-pages/moveE" class="ref-item">moveE()</a><br>
+        <span class="ref-info">Move relative to current position in E.</span>
+      </td>
+      <td>
+        <a href="reference-pages/moveExtrude" class="ref-item">moveExtrude()</a><br>
+        <span class="ref-info">Move to an x,y,z position while extruding.</span>        
+      </td>
+      <td>
+        <a href="reference-pages/travelTo" class="ref-item">travelTo()</a><br>
+        <span class="ref-info">Move to an x,y,z position with a z-hop.</span>
+      </td>
+    </tr>
+  </tbody>
+</table>
+<h3 id="g--m-codes">
+  G &amp; M Codes
+  <a class="anchor" href="#g--m-codes">#</a>
+</h3>
+<table>
+  <tbody>
+    <tr>
+        <td>
+            <a href="reference-pages/autohome" class="ref-item">autoHome()</a><br>
+            <span class="ref-info">Autohome the machine.</span>
+        </td>
+        <td>
+            <a href="reference-pages/setBedT" class="ref-item">setBedT()</a><br>
+            <span class="ref-info">Set bed temperature.</span>
+        </td>
+        <td>
+            <a href="reference-pages/setNozzleT" class="ref-item">setNozzleT()</a><br>
+            <span class="ref-info">Set nozzle temperature.</span>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            <a href="reference-pages/setTemps" class="ref-item">setTemps()</a><br>
+            <span class="ref-info">Set nozzle & bed temperatures.</span>
+        </td>
+        <td>
+          <a href="reference-pages/setAbsolutePosition" class="ref-item">setAbsolutePosition()</a><br>
+          <span class="ref-info">Use absolute coordinates.</span>
+        </td>
+        <td>
+          <a href="reference-pages/setAbsolutePositionXYZ" class="ref-item">setAbsolutePositionXYZ()</a><br>
+          <span class="ref-info">Use absolute coordinates for dimensional axes.</span>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            <a href="reference-pages/setEAbsolute" class="ref-item">setEAbsolute()</a><br>
+            <span class="ref-info">Use absolute coordinates for extruder position.</span>
+        </td>
+        <td>
+          <a href="reference-pages/setERelative" class="ref-item">setERelative()</a><br>
+            <span class="ref-info">Use relative coordinates for extruder position.</span>
+        </td>
+    </tr>
+  </tbody>
+</table>
 </article>
  
       
@@ -763,106 +376,10 @@ <h3 id="parameters-16">
   
 <nav id="TableOfContents">
   <ul>
-    <li><a href="#fab">Fab</a>
-      <ul>
-        <li><a href="#syntax">Syntax</a></li>
-        <li><a href="#parameters">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#autohome">autoHome</a>
-      <ul>
-        <li><a href="#syntax-1">Syntax</a></li>
-        <li><a href="#parameters-1">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#setnozzlet">setNozzleT</a>
-      <ul>
-        <li><a href="#syntax-2">Syntax</a></li>
-        <li><a href="#parameters-2">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#setbedt">setBedT</a>
-      <ul>
-        <li><a href="#syntax-3">Syntax</a></li>
-        <li><a href="#parameters-3">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#settemps">setTemps</a>
-      <ul>
-        <li><a href="#syntax-4">Syntax</a></li>
-        <li><a href="#parameters-4">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#moveto">moveTo</a>
-      <ul>
-        <li><a href="#syntax-5">Syntax</a></li>
-        <li><a href="#parameters-5">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetox">moveToX</a>
-      <ul>
-        <li><a href="#syntax-6">Syntax</a></li>
-        <li><a href="#parameters-6">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetoy">moveToY</a>
-      <ul>
-        <li><a href="#syntax-7">Syntax</a></li>
-        <li><a href="#parameters-7">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetoz">moveToZ</a>
-      <ul>
-        <li><a href="#syntax-8">Syntax</a></li>
-        <li><a href="#parameters-8">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movetoe">moveToE</a>
-      <ul>
-        <li><a href="#syntax-9">Syntax</a></li>
-        <li><a href="#parameters-9">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#move">move</a>
-      <ul>
-        <li><a href="#syntax-10">Syntax</a></li>
-        <li><a href="#parameters-10">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movex">moveX</a>
-      <ul>
-        <li><a href="#syntax-11">Syntax</a></li>
-        <li><a href="#parameters-11">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movey">moveY</a>
-      <ul>
-        <li><a href="#syntax-12">Syntax</a></li>
-        <li><a href="#parameters-12">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movez">moveZ</a>
-      <ul>
-        <li><a href="#syntax-13">Syntax</a></li>
-        <li><a href="#parameters-13">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#movee">moveE</a>
-      <ul>
-        <li><a href="#syntax-14">Syntax</a></li>
-        <li><a href="#parameters-14">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#travelto">travelTo</a>
-      <ul>
-        <li><a href="#syntax-15">Syntax</a></li>
-        <li><a href="#parameters-15">Parameters</a></li>
-      </ul>
-    </li>
-    <li><a href="#moveextrude">moveExtrude</a>
+    <li><a href="#a-hrefreference-pagesfabfaba"><a href="reference-pages/fab">Fab</a></a>
       <ul>
-        <li><a href="#syntax-16">Syntax</a></li>
-        <li><a href="#parameters-16">Parameters</a></li>
+        <li><a href="#path-commands">Path Commands</a></li>
+        <li><a href="#g--m-codes">G &amp; M Codes</a></li>
       </ul>
     </li>
   </ul>
diff --git a/public/docs/reference/index.xml b/public/docs/reference/index.xml
new file mode 100644
index 0000000..1718a34
--- /dev/null
+++ b/public/docs/reference/index.xml
@@ -0,0 +1,158 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>p5.fab</title>
+    <link>http://localhost:1313/docs/reference/</link>
+    <description>Recent content on p5.fab</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    <atom:link href="http://localhost:1313/docs/reference/index.xml" rel="self" type="application/rss+xml" />
+    <item>
+      <title>Autohome</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/autohome/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/autohome/</guid>
+      <description>autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None</description>
+    </item>
+    <item>
+      <title>Fab</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/fab/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/fab/</guid>
+      <description> Fab # A class to describe a fabrication machine.&#xA;A fab object represents a 3D printer. It is comprised of the following information:&#xA;workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])&#xA;Parameters # config: a json object specifying requisite machine information </description>
+    </item>
+    <item>
+      <title>Move</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/move/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/move/</guid>
+      <description>move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move Extrude</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/moveextrude/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/moveextrude/</guid>
+      <description>moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional.</description>
+    </item>
+    <item>
+      <title>Move To</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/moveto/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/moveto/</guid>
+      <description>moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move To E</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetoe/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetoe/</guid>
+      <description>moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</description>
+    </item>
+    <item>
+      <title>Move To X</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetox/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetox/</guid>
+      <description>moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move To X</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movex/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movex/</guid>
+      <description>moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move To Y</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetoy/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetoy/</guid>
+      <description>moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move Y</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movey/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movey/</guid>
+      <description>moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>moveE</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movee/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movee/</guid>
+      <description>moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>MoveToZ</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetoz/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetoz/</guid>
+      <description>moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>MoveZ</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movez/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movez/</guid>
+      <description>moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Set Absolute Position</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setabsoluteposition/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setabsoluteposition/</guid>
+      <description>setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), &amp;amp; setERelative().&#xA;Syntax # fab.setAbsolutePosition() Parameters # None</description>
+    </item>
+    <item>
+      <title>Set Absolute Position XYZ</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setabsolutepositionxyz/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setabsolutepositionxyz/</guid>
+      <description>setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None</description>
+    </item>
+    <item>
+      <title>Set Bed Temp</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setbedt/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setbedt/</guid>
+      <description>setBedT() Set the printer&#39;s bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&amp;rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.&#xA;Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding.</description>
+    </item>
+    <item>
+      <title>Set E Absolute</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/seteabsolute/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/seteabsolute/</guid>
+      <description>setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None</description>
+    </item>
+    <item>
+      <title>Set E Relative</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/seterelative/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/seterelative/</guid>
+      <description>setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None</description>
+    </item>
+    <item>
+      <title>Set Nozzle Temp</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setnozzlet/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setnozzlet/</guid>
+      <description>setNozzleT() Set the printer&#39;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&amp;rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.&#xA;Syntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding.</description>
+    </item>
+    <item>
+      <title>Set Temps</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/settemps/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/settemps/</guid>
+      <description>setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won&amp;rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.&#xA;Syntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding.</description>
+    </item>
+    <item>
+      <title>Travel To</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/travelto/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/travelto/</guid>
+      <description>travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.&#xA;Syntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional.</description>
+    </item>
+  </channel>
+</rss>
diff --git a/public/docs/reference/reference-pages/autohome/index.html b/public/docs/reference/reference-pages/autohome/index.html
new file mode 100644
index 0000000..d213fcb
--- /dev/null
+++ b/public/docs/reference/reference-pages/autohome/index.html
@@ -0,0 +1,274 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Autohome" />
+<meta property="og:description" content="autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/autohome/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Autohome | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/autohome/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Autohome</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#syntax">Syntax</a></li>
+    <li><a href="#parameters">Parameters</a></li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">autoHome()</h2>
+Autohome the machine (with a <code>G28</code> command) and zero the extruder position (with a <code>G92 E0</code> command). 
+<h2 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h2>
+<pre tabindex="0"><code>fab.autoHome()
+</code></pre><h2 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h2>
+<p>None</p>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#syntax">Syntax</a></li>
+    <li><a href="#parameters">Parameters</a></li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/fab/index.html b/public/docs/reference/reference-pages/fab/index.html
new file mode 100644
index 0000000..3770cd9
--- /dev/null
+++ b/public/docs/reference/reference-pages/fab/index.html
@@ -0,0 +1,300 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content=" Fab # A class to describe a fabrication machine.
+A fab object represents a 3D printer. It is comprised of the following information:
+workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])
+Parameters # config: a json object specifying requisite machine information ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Fab" />
+<meta property="og:description" content=" Fab # A class to describe a fabrication machine.
+A fab object represents a 3D printer. It is comprised of the following information:
+workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])
+Parameters # config: a json object specifying requisite machine information " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/fab/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Fab | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/fab/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Fab</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#fab">Fab</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 id="fab">
+  Fab
+  <a class="anchor" href="#fab">#</a>
+</h2>
+<p>A class to describe a fabrication machine.</p>
+<p>A <code>fab</code> object represents a 3D printer. It is comprised of the following information:</p>
+<ul>
+<li><code>workEnvelope</code>: maximum X, Y, and Z dimensions of the machine</li>
+<li><code>nozzleDiameter</code>: Diameter of the nozzle in mm</li>
+<li><code>filamentDiameter</code>: Diameter of filament in mm</li>
+<li><code>name</code>: a human readable string to identify this machine</li>
+</ul>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<p><code>fab([config])</code></p>
+<h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<ul>
+<li>config: a json object specifying requisite machine information</li>
+</ul>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li><a href="#fab">Fab</a>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/move/index.html b/public/docs/reference/reference-pages/move/index.html
new file mode 100644
index 0000000..c6f3455
--- /dev/null
+++ b/public/docs/reference/reference-pages/move/index.html
@@ -0,0 +1,290 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move" />
+<meta property="og:description" content="move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/move/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/move/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">move()</h2>
+Move relative to the current position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.move(dx, dy, dz, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">dx</div>
+ <div class="grid-item">Number, the relative x distance to move (in current units, mm by default)</div>
+ <div class="grid-item">dy</div>
+ <div class="grid-item">Number, the relative y distance to move (in current units, mm by default)</div>
+ <div class="grid-item">dz</div>
+ <div class="grid-item">Number, the relative z distance to move (in current units, mm by default)</div>
+ <div class="grid-item">velocity</div>
+ <div class="grid-item">v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movee/index.html b/public/docs/reference/reference-pages/movee/index.html
new file mode 100644
index 0000000..5c8d3a1
--- /dev/null
+++ b/public/docs/reference/reference-pages/movee/index.html
@@ -0,0 +1,287 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="moveE" />
+<meta property="og:description" content="moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movee/" /><meta property="article:section" content="docs" />
+
+
+
+<title>moveE | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movee/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>moveE</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveE()</h2>
+Move in E relative to the current position.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveE(de, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">de</div>
+ <div class="grid-item">Number, the relative e distance to move (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/moveextrude/index.html b/public/docs/reference/reference-pages/moveextrude/index.html
new file mode 100644
index 0000000..0bbfe4d
--- /dev/null
+++ b/public/docs/reference/reference-pages/moveextrude/index.html
@@ -0,0 +1,294 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move Extrude" />
+<meta property="og:description" content="moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/moveextrude/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move Extrude | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/moveextrude/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move Extrude</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveExtrude()</h2>
+Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+ <div class="grid-item">y</div>
+ <div class="grid-item">Number, the y position to move to (in current units, mm by default)</div>
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+<div class="grid-item">extrusion</div>
+ <div class="grid-item">Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter</div>
+<div class="grid-item">multiplication</div>
+ <div class="grid-item">Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default.</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/moveto/index.html b/public/docs/reference/reference-pages/moveto/index.html
new file mode 100644
index 0000000..0058024
--- /dev/null
+++ b/public/docs/reference/reference-pages/moveto/index.html
@@ -0,0 +1,290 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To" />
+<meta property="og:description" content="moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/moveto/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/moveto/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveTo()</h2>
+Move directly to an absolute (x,y,z) position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveTo(x, y, z, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+ <div class="grid-item">y</div>
+ <div class="grid-item">y: Number, the y position to move to (in current units, mm by default)</div>
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movetoe/index.html b/public/docs/reference/reference-pages/movetoe/index.html
new file mode 100644
index 0000000..25b5c09
--- /dev/null
+++ b/public/docs/reference/reference-pages/movetoe/index.html
@@ -0,0 +1,288 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To E" />
+<meta property="og:description" content="moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movetoe/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To E | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movetoe/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To E</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveToE()</h2>
+Move directly to an absolute E position.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveToE(e, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">e</div>
+ <div class="grid-item">e: Number, the e position to move to (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
+- e: Number, the e position to move to (in current units, mm by default)
+- v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movetox/index.html b/public/docs/reference/reference-pages/movetox/index.html
new file mode 100644
index 0000000..0612168
--- /dev/null
+++ b/public/docs/reference/reference-pages/movetox/index.html
@@ -0,0 +1,287 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To X" />
+<meta property="og:description" content="moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movetox/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To X | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movetox/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To X</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveToX()</h2>
+Move directly to an absolute X position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveToX(x, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movetoy/index.html b/public/docs/reference/reference-pages/movetoy/index.html
new file mode 100644
index 0000000..17a90df
--- /dev/null
+++ b/public/docs/reference/reference-pages/movetoy/index.html
@@ -0,0 +1,286 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To Y" />
+<meta property="og:description" content="moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movetoy/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To Y | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movetoy/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To Y</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveToY()</h2>
+Move directly to an absolute Y position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveToY(y, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">y</div>
+ <div class="grid-item">Number, the y position to move to (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movetoz/index.html b/public/docs/reference/reference-pages/movetoz/index.html
new file mode 100644
index 0000000..28ad982
--- /dev/null
+++ b/public/docs/reference/reference-pages/movetoz/index.html
@@ -0,0 +1,286 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="MoveToZ" />
+<meta property="og:description" content="moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movetoz/" /><meta property="article:section" content="docs" />
+
+
+
+<title>MoveToZ | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movetoz/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>MoveToZ</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveToZ()</h2>
+Move directly to an absolute Z position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveToZ(z, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movex/index.html b/public/docs/reference/reference-pages/movex/index.html
new file mode 100644
index 0000000..9c2ceab
--- /dev/null
+++ b/public/docs/reference/reference-pages/movex/index.html
@@ -0,0 +1,286 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move To X" />
+<meta property="og:description" content="moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movex/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move To X | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movex/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move To X</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveX()</h2>
+Move in X relative to the current position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveX(dx, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">dx</div>
+ <div class="grid-item">Number, the relative x distance to move (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movey/index.html b/public/docs/reference/reference-pages/movey/index.html
new file mode 100644
index 0000000..1f57a33
--- /dev/null
+++ b/public/docs/reference/reference-pages/movey/index.html
@@ -0,0 +1,287 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Move Y" />
+<meta property="og:description" content="moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movey/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Move Y | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movey/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Move Y</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveY()</h2>
+Move in Y relative to the current position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveY(dy, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">dy</div>
+ <div class="grid-item">Number, the relative y distance to move (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/movez/index.html b/public/docs/reference/reference-pages/movez/index.html
new file mode 100644
index 0000000..8d08ba0
--- /dev/null
+++ b/public/docs/reference/reference-pages/movez/index.html
@@ -0,0 +1,287 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) ">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="MoveZ" />
+<meta property="og:description" content="moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) " />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/movez/" /><meta property="article:section" content="docs" />
+
+
+
+<title>MoveZ | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/movez/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>MoveZ</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">moveZ()</h2>
+Move in Z relative to the current position without extruding material.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.moveZ(dz, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">dz</div>
+ <div class="grid-item">Number, the relative z distance to move (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/setabsoluteposition/index.html b/public/docs/reference/reference-pages/setabsoluteposition/index.html
new file mode 100644
index 0000000..10f3dcd
--- /dev/null
+++ b/public/docs/reference/reference-pages/setabsoluteposition/index.html
@@ -0,0 +1,285 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), &amp; setERelative().
+Syntax # fab.setAbsolutePosition() Parameters # None">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set Absolute Position" />
+<meta property="og:description" content="setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), &amp; setERelative().
+Syntax # fab.setAbsolutePosition() Parameters # None" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/setabsoluteposition/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Absolute Position | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/setabsoluteposition/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Absolute Position</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">setAbsolutePosition()</h2>
+Set coordinates to absolute positioning, relative to the origin of the machine (using a <code>G90</code> command).
+<p>Note that <code>G90</code> behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see <a href="../setAbsolutePositionXYZ" class="ref-item">setAbsolutePositionXYZ()</a>, <a href="../setRelativePositionXYZ" class="ref-item">setRelativePositionXYZ()</a>, <a href="../reference-pages/setEAbsolute" class="ref-item">setEAbsolute()</a>, &amp; <a href="../reference-pages/setERelative" class="ref-item">setERelative()</a>.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.setAbsolutePosition()
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<p>None</p>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/setabsolutepositionxyz/index.html b/public/docs/reference/reference-pages/setabsolutepositionxyz/index.html
new file mode 100644
index 0000000..0933fb3
--- /dev/null
+++ b/public/docs/reference/reference-pages/setabsolutepositionxyz/index.html
@@ -0,0 +1,282 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set Absolute Position XYZ" />
+<meta property="og:description" content="setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/setabsolutepositionxyz/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Absolute Position XYZ | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/setabsolutepositionxyz/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Absolute Position XYZ</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">setAbsolutePositionXYZ()</h2>
+Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.setAbsolutePositionXYZ()
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<p>None</p>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/setbedt/index.html b/public/docs/reference/reference-pages/setbedt/index.html
new file mode 100644
index 0000000..0e8109f
--- /dev/null
+++ b/public/docs/reference/reference-pages/setbedt/index.html
@@ -0,0 +1,289 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setBedT() Set the printer&#39;s bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set Bed Temp" />
+<meta property="og:description" content="setBedT() Set the printer&#39;s bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/setbedt/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Bed Temp | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/setbedt/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Bed Temp</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">setBedT()</h2>
+Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.
+<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.setBedT(temperature, [wait])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">temperature</div>
+ <div class="grid-item">Number, the temperature to heat the bed to in degrees Celcius</div>
+ <div class="grid-item">wait</div>
+ <div class="grid-item">Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default.</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/seteabsolute/index.html b/public/docs/reference/reference-pages/seteabsolute/index.html
new file mode 100644
index 0000000..68387af
--- /dev/null
+++ b/public/docs/reference/reference-pages/seteabsolute/index.html
@@ -0,0 +1,282 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set E Absolute" />
+<meta property="og:description" content="setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/seteabsolute/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set E Absolute | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/seteabsolute/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set E Absolute</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">setEAbsolute()</h2>
+Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.setEAbsolute()
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<p>None</p>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/seterelative/index.html b/public/docs/reference/reference-pages/seterelative/index.html
new file mode 100644
index 0000000..2b50172
--- /dev/null
+++ b/public/docs/reference/reference-pages/seterelative/index.html
@@ -0,0 +1,282 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set E Relative" />
+<meta property="og:description" content="setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None" />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/seterelative/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set E Relative | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/seterelative/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set E Relative</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">setERelative()</h2>
+Set extruder axis to use relative position without changing the dimensional axes positioning mode.
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.setERelative()
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<p>None</p>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/setnozzlet/index.html b/public/docs/reference/reference-pages/setnozzlet/index.html
new file mode 100644
index 0000000..69d670a
--- /dev/null
+++ b/public/docs/reference/reference-pages/setnozzlet/index.html
@@ -0,0 +1,289 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setNozzleT() Set the printer&#39;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set Nozzle Temp" />
+<meta property="og:description" content="setNozzleT() Set the printer&#39;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/setnozzlet/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Nozzle Temp | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/setnozzlet/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Nozzle Temp</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">setNozzleT()</h2>
+Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.
+<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.setNozzleT(temperature, [wait])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">temperature</div>
+ <div class="grid-item">Number, the temperature to heat the nozzle to in degrees Celcius</div>
+ <div class="grid-item">wait</div>
+ <div class="grid-item">Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default.</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/settemps/index.html b/public/docs/reference/reference-pages/settemps/index.html
new file mode 100644
index 0000000..64ad5e7
--- /dev/null
+++ b/public/docs/reference/reference-pages/settemps/index.html
@@ -0,0 +1,291 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Set Temps" />
+<meta property="og:description" content="setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.
+Syntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/settemps/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Set Temps | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/settemps/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Set Temps</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">setTemps()</h2>
+Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.
+<p>Most firmware won&rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.setTemps(nozzleTemperature, bedTemperature, [wait])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">nozzleTemperature</div>
+ <div class="grid-item">Number, the temperature to heat the nozzle to in degrees Celcius</div>
+ <div class="grid-item">bedTemperature</div>
+ <div class="grid-item">Number, the temperature to heat the bed to in degrees Celcius</div>
+ <div class="grid-item">wait</div>
+ <div class="grid-item">Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default.</div>
+</div></article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/reference/reference-pages/travelto/index.html b/public/docs/reference/reference-pages/travelto/index.html
new file mode 100644
index 0000000..6547017
--- /dev/null
+++ b/public/docs/reference/reference-pages/travelto/index.html
@@ -0,0 +1,294 @@
+<!DOCTYPE html>
+<html lang="en-us" dir="ltr">
+<head><script src="/livereload.js?mindelay=10&amp;v=2&amp;port=1313&amp;path=livereload" data-no-instant defer></script>
+  <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.
+Syntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional.">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
+<meta name="color-scheme" content="light dark"><meta property="og:title" content="Travel To" />
+<meta property="og:description" content="travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.
+Syntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional." />
+<meta property="og:type" content="article" />
+<meta property="og:url" content="http://localhost:1313/docs/reference/reference-pages/travelto/" /><meta property="article:section" content="docs" />
+
+
+
+<title>Travel To | p5.fab</title>
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/favicon.png" >
+<link rel="canonical" href="http://localhost:1313/docs/reference/reference-pages/travelto/">
+<link rel="stylesheet" href="/book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css" integrity="sha256-Qk7YIZ8Ai5Y&#43;DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8=" crossorigin="anonymous">
+  <script defer src="/flexsearch.min.js"></script>
+  <script defer src="/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js" integrity="sha256-lWZqQ7CBntKTqq6uMu9j4y1AhzsDTHxd4lYZoIU4CQs=" crossorigin="anonymous"></script>
+<!--
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+-->
+  
+</head>
+<body dir="ltr">
+  <input type="checkbox" class="hidden toggle" id="menu-control" />
+  <input type="checkbox" class="hidden toggle" id="toc-control" />
+  <main class="container flex">
+    <aside class="book-menu">
+      <div class="book-menu-content">
+        
+  <nav>
+<h2 class="book-brand">
+  <a class="flex align-center" href="/"><span>p5.fab</span>
+  </a>
+</h2>
+
+
+<div class="book-search">
+  <input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
+  <div class="book-search-spinner hidden"></div>
+  <ul id="book-search-results"></ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+  
+
+
+
+  
+  <ul>
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/quickstart/" class="">Quickstart</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/machine-compatibility/" class="">Machine Compatibility</a>
+  
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/resources/" class="">Resources</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+      
+        <li>
+          
+  
+  
+
+  
+    <a href="/docs/reference/" class="">Reference</a>
+  
+
+          
+  <ul>
+    
+  </ul>
+
+        </li>
+      
+    
+  </ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</nav>
+
+
+
+
+  <script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
+
+
+ 
+      </div>
+    </aside>
+
+    <div class="book-page">
+      <header class="book-header">
+        
+  <div class="flex align-center justify-between">
+  <label for="menu-control">
+    <img src="/svg/menu.svg" class="book-icon" alt="Menu" />
+  </label>
+
+  <strong>Travel To</strong>
+
+  <label for="toc-control">
+    
+    <img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
+    
+  </label>
+</div>
+
+
+  
+  <aside class="hidden clearfix">
+    
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+
+  </aside>
+  
+ 
+      </header>
+
+      
+      
+  <article class="markdown book-article"><h2 class="ref-header">travelTo()</h2>
+Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.
+<p>The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.</p>
+<h3 id="syntax">
+  Syntax
+  <a class="anchor" href="#syntax">#</a>
+</h3>
+<pre tabindex="0"><code>fab.travelTo(x, y, z, [velocity])
+</code></pre><h3 id="parameters">
+  Parameters
+  <a class="anchor" href="#parameters">#</a>
+</h3>
+<div class="grid-container">
+ <div class="grid-item">x</div>
+ <div class="grid-item">Number, the x position to move to (in current units, mm by default)</div>
+ <div class="grid-item">y</div>
+ <div class="grid-item">y: Number, the y position to move to (in current units, mm by default)</div>
+ <div class="grid-item">z</div>
+ <div class="grid-item">Number, the z position to move to (in current units, mm by default)</div>
+ <div class="grid-item">v</div>
+ <div class="grid-item">v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default)</div>
+</div>
+</article>
+ 
+      
+
+      <footer class="book-footer">
+        
+  <div class="flex flex-wrap justify-between">
+
+
+
+
+
+</div>
+
+
+
+  <script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
+
+
+ 
+        
+      </footer>
+
+      
+  
+  <div class="book-comments">
+
+</div>
+  
+ 
+
+      <label for="menu-control" class="hidden book-menu-overlay"></label>
+    </div>
+
+    
+    <aside class="book-toc">
+      <div class="book-toc-content">
+        
+  
+<nav id="TableOfContents">
+  <ul>
+    <li>
+      <ul>
+        <li><a href="#syntax">Syntax</a></li>
+        <li><a href="#parameters">Parameters</a></li>
+      </ul>
+    </li>
+  </ul>
+</nav>
+
+
+ 
+      </div>
+    </aside>
+    
+  </main>
+
+  
+</body>
+</html>
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/public/docs/resources/guides/cc-intro/index.html b/public/docs/resources/guides/cc-intro/index.html
index 3932482..be6d7da 100644
--- a/public/docs/resources/guides/cc-intro/index.html
+++ b/public/docs/resources/guides/cc-intro/index.html
@@ -17,9 +17,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/resources/guides/cc-intro/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -103,41 +103,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="active">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -149,24 +115,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -175,7 +128,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -186,19 +139,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/resources/guides/dfab-intro/index.html b/public/docs/resources/guides/dfab-intro/index.html
index 6e70440..dff1383 100644
--- a/public/docs/resources/guides/dfab-intro/index.html
+++ b/public/docs/resources/guides/dfab-intro/index.html
@@ -17,9 +17,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/resources/guides/dfab-intro/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -103,41 +103,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="active">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -149,24 +115,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -175,7 +128,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -186,19 +139,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/resources/guides/p5fab-primer/index.html b/public/docs/resources/guides/p5fab-primer/index.html
index d884667..b43203a 100644
--- a/public/docs/resources/guides/p5fab-primer/index.html
+++ b/public/docs/resources/guides/p5fab-primer/index.html
@@ -19,9 +19,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/resources/guides/p5fab-primer/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -105,41 +105,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="active">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -151,24 +117,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -177,7 +130,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -188,19 +141,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/resources/index.html b/public/docs/resources/index.html
index f3ce04c..087a010 100644
--- a/public/docs/resources/index.html
+++ b/public/docs/resources/index.html
@@ -17,9 +17,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/resources/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <link rel="alternate" type="application/rss+xml" href="http://localhost:1313/docs/resources/index.xml" title="p5.fab" />
 <!--
 Made with Book Theme
@@ -104,41 +104,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -150,24 +116,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -176,7 +129,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -187,19 +140,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/resources/index.xml b/public/docs/resources/index.xml
index 313f2ea..ea1b3f2 100644
--- a/public/docs/resources/index.xml
+++ b/public/docs/resources/index.xml
@@ -7,13 +7,6 @@
     <generator>Hugo -- gohugo.io</generator>
     <language>en-us</language>
     <atom:link href="http://localhost:1313/docs/resources/index.xml" rel="self" type="application/rss+xml" />
-    <item>
-      <title>A Gentle Introduction to Digital Fabrication</title>
-      <link>http://localhost:1313/docs/resources/guides/dfab-intro/</link>
-      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/resources/guides/dfab-intro/</guid>
-      <description>A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.</description>
-    </item>
     <item>
       <title>A Gentle Introduction to Creative Coding with p5.js</title>
       <link>http://localhost:1313/docs/resources/guides/cc-intro/</link>
@@ -22,11 +15,11 @@
       <description>A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.</description>
     </item>
     <item>
-      <title>p5.fab Primer</title>
-      <link>http://localhost:1313/docs/resources/guides/p5fab-primer/</link>
+      <title>A Gentle Introduction to Digital Fabrication</title>
+      <link>http://localhost:1313/docs/resources/guides/dfab-intro/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/resources/guides/p5fab-primer/</guid>
-      <description>p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.&#xA;Anatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go!</description>
+      <guid>http://localhost:1313/docs/resources/guides/dfab-intro/</guid>
+      <description>A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.</description>
     </item>
     <item>
       <title>Cube Tutorial</title>
@@ -35,6 +28,13 @@
       <guid>http://localhost:1313/docs/resources/tutorials/cube-tutorial/</guid>
       <description>Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.</description>
     </item>
+    <item>
+      <title>Line Vase Tutorial</title>
+      <link>http://localhost:1313/docs/resources/tutorials/line-vase-tutorial/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/resources/tutorials/line-vase-tutorial/</guid>
+      <description>Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.</description>
+    </item>
     <item>
       <title>Non-Planar Printing Tutorial</title>
       <link>http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/</link>
@@ -43,11 +43,11 @@
       <description>Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.</description>
     </item>
     <item>
-      <title>Line Vase Tutorial</title>
-      <link>http://localhost:1313/docs/resources/tutorials/line-vase-tutorial/</link>
+      <title>p5.fab Primer</title>
+      <link>http://localhost:1313/docs/resources/guides/p5fab-primer/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/resources/tutorials/line-vase-tutorial/</guid>
-      <description>Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.</description>
+      <guid>http://localhost:1313/docs/resources/guides/p5fab-primer/</guid>
+      <description>p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.&#xA;Anatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go!</description>
     </item>
   </channel>
 </rss>
diff --git a/public/docs/resources/tutorials/cube-tutorial/index.html b/public/docs/resources/tutorials/cube-tutorial/index.html
index a35e2af..718d49b 100644
--- a/public/docs/resources/tutorials/cube-tutorial/index.html
+++ b/public/docs/resources/tutorials/cube-tutorial/index.html
@@ -17,9 +17,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/resources/tutorials/cube-tutorial/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -103,41 +103,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -149,24 +115,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="active">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -175,7 +128,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -186,19 +139,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/resources/tutorials/line-vase-tutorial/index.html b/public/docs/resources/tutorials/line-vase-tutorial/index.html
index 111c106..e567548 100644
--- a/public/docs/resources/tutorials/line-vase-tutorial/index.html
+++ b/public/docs/resources/tutorials/line-vase-tutorial/index.html
@@ -17,9 +17,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/resources/tutorials/line-vase-tutorial/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -103,41 +103,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -149,24 +115,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -175,7 +128,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="active">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -186,19 +139,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/docs/resources/tutorials/non-planar-tutorial/index.html b/public/docs/resources/tutorials/non-planar-tutorial/index.html
index aab4175..eb13bca 100644
--- a/public/docs/resources/tutorials/non-planar-tutorial/index.html
+++ b/public/docs/resources/tutorials/non-planar-tutorial/index.html
@@ -17,9 +17,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <!--
 Made with Book Theme
 https://github.com/alex-shpak/hugo-book
@@ -103,41 +103,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -149,24 +115,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="active">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -175,7 +128,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -186,19 +139,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/en.search-data.min.00e40082f8fc8cb6a922a8b64004e43073b3529d0b5cfddc90692fa868fc35c2.json b/public/en.search-data.min.00e40082f8fc8cb6a922a8b64004e43073b3529d0b5cfddc90692fa868fc35c2.json
new file mode 100644
index 0000000..09f31e0
--- /dev/null
+++ b/public/en.search-data.min.00e40082f8fc8cb6a922a8b64004e43073b3529d0b5cfddc90692fa868fc35c2.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.029e88f856b43e6755e9b4b8eda4badc7b7913d64a4ed055dea05c5b2d04446e.json b/public/en.search-data.min.029e88f856b43e6755e9b4b8eda4badc7b7913d64a4ed055dea05c5b2d04446e.json
new file mode 100644
index 0000000..3839458
--- /dev/null
+++ b/public/en.search-data.min.029e88f856b43e6755e9b4b8eda4badc7b7913d64a4ed055dea05c5b2d04446e.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":18,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":19,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmove # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.03f3c1ecf90ff6b881143e6b0097e69bd76e5c051cd3ee6e27416d40471231a4.json b/public/en.search-data.min.03f3c1ecf90ff6b881143e6b0097e69bd76e5c051cd3ee6e27416d40471231a4.json
new file mode 100644
index 0000000..8c6dc37
--- /dev/null
+++ b/public/en.search-data.min.03f3c1ecf90ff6b881143e6b0097e69bd76e5c051cd3ee6e27416d40471231a4.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.048ef4df4358980e4f119d4036c3fc0e6a6a21fd9d2158798630e30fccbfa641.json b/public/en.search-data.min.048ef4df4358980e4f119d4036c3fc0e6a6a21fd9d2158798630e30fccbfa641.json
new file mode 100644
index 0000000..a2e9889
--- /dev/null
+++ b/public/en.search-data.min.048ef4df4358980e4f119d4036c3fc0e6a6a21fd9d2158798630e30fccbfa641.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.0745cdc6706f1058d039ebc7a5133c574c68fffa371091bc49bb66cd064a724a.json b/public/en.search-data.min.0745cdc6706f1058d039ebc7a5133c574c68fffa371091bc49bb66cd064a724a.json
new file mode 100644
index 0000000..f5579cc
--- /dev/null
+++ b/public/en.search-data.min.0745cdc6706f1058d039ebc7a5133c574c68fffa371091bc49bb66cd064a724a.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position Xyz","section":"Reference","content":"to come\n"},{"id":5,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":6,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":8,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":9,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":11,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":12,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":13,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":15,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":22,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":23,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that behaviour differs depending on firmware. For example, G90 on Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions seperately, see \u0026lt;ssetAbsolutePositionXYZ().\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.07da1c07887873ff0ed10034829f7fe104d2733eaeaf7b7d05a2333e7025a671.json b/public/en.search-data.min.07da1c07887873ff0ed10034829f7fe104d2733eaeaf7b7d05a2333e7025a671.json
new file mode 100644
index 0000000..0c86caf
--- /dev/null
+++ b/public/en.search-data.min.07da1c07887873ff0ed10034829f7fe104d2733eaeaf7b7d05a2333e7025a671.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nGCodes # autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.0af9bb263c482228c0bb0ef7873f8914acf1dbfcd47a07db3991689d11479374.json b/public/en.search-data.min.0af9bb263c482228c0bb0ef7873f8914acf1dbfcd47a07db3991689d11479374.json
new file mode 100644
index 0000000..6047d29
--- /dev/null
+++ b/public/en.search-data.min.0af9bb263c482228c0bb0ef7873f8914acf1dbfcd47a07db3991689d11479374.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.11970372873f60a48f95e439cffeb1c837eb8987f710edb230037cde896c3f5f.json b/public/en.search-data.min.11970372873f60a48f95e439cffeb1c837eb8987f710edb230037cde896c3f5f.json
new file mode 100644
index 0000000..d070ab7
--- /dev/null
+++ b/public/en.search-data.min.11970372873f60a48f95e439cffeb1c837eb8987f710edb230037cde896c3f5f.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nmoveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.154f7a8647a8102e314414ab527155ac0269d10f548c9349f17900f8c7f83371.json b/public/en.search-data.min.154f7a8647a8102e314414ab527155ac0269d10f548c9349f17900f8c7f83371.json
new file mode 100644
index 0000000..0d6adfb
--- /dev/null
+++ b/public/en.search-data.min.154f7a8647a8102e314414ab527155ac0269d10f548c9349f17900f8c7f83371.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. setEAbsolute()\nUse absolute coordinates for extruder position. setERelative()\nUse relative coordinates for extruder position. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.1556011805b59dec4ab3d9a0edf74207a27381ebeed46abd8f9d36faca646b33.json b/public/en.search-data.min.1556011805b59dec4ab3d9a0edf74207a27381ebeed46abd8f9d36faca646b33.json
new file mode 100644
index 0000000..6e59d32
--- /dev/null
+++ b/public/en.search-data.min.1556011805b59dec4ab3d9a0edf74207a27381ebeed46abd8f9d36faca646b33.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X coordinate.\nmoveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.165780119ee4cfe69ff1bd1b15899881ec0273271360f28f28435bd07f28fdfb.json b/public/en.search-data.min.165780119ee4cfe69ff1bd1b15899881ec0273271360f28f28435bd07f28fdfb.json
new file mode 100644
index 0000000..f6525ef
--- /dev/null
+++ b/public/en.search-data.min.165780119ee4cfe69ff1bd1b15899881ec0273271360f28f28435bd07f28fdfb.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.1be1adeec26200029d2af9a07cf8a54f33223e7e0614671cc64d036a8bd5a8f3.json b/public/en.search-data.min.1be1adeec26200029d2af9a07cf8a54f33223e7e0614671cc64d036a8bd5a8f3.json
new file mode 100644
index 0000000..0949143
--- /dev/null
+++ b/public/en.search-data.min.1be1adeec26200029d2af9a07cf8a54f33223e7e0614671cc64d036a8bd5a8f3.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.1de78ec5fba7c2a50151baf821e0a5f18b7840891b83f26f6faae6426c099e46.json b/public/en.search-data.min.1de78ec5fba7c2a50151baf821e0a5f18b7840891b83f26f6faae6426c099e46.json
new file mode 100644
index 0000000..6fa1b73
--- /dev/null
+++ b/public/en.search-data.min.1de78ec5fba7c2a50151baf821e0a5f18b7840891b83f26f6faae6426c099e46.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.1eeb3810eb70dcd6d62a8495adb9ce9f941e9def9bfe3a1c51c48c886690209c.json b/public/en.search-data.min.1eeb3810eb70dcd6d62a8495adb9ce9f941e9def9bfe3a1c51c48c886690209c.json
new file mode 100644
index 0000000..cdc2cd9
--- /dev/null
+++ b/public/en.search-data.min.1eeb3810eb70dcd6d62a8495adb9ce9f941e9def9bfe3a1c51c48c886690209c.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveX()\nMove relative to current position in X.\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.2421ceaa5fa80dc1237e0e9889791a108f8af987ef2aed3b18896ca71eba91c2.json b/public/en.search-data.min.2421ceaa5fa80dc1237e0e9889791a108f8af987ef2aed3b18896ca71eba91c2.json
new file mode 100644
index 0000000..83bb1a5
--- /dev/null
+++ b/public/en.search-data.min.2421ceaa5fa80dc1237e0e9889791a108f8af987ef2aed3b18896ca71eba91c2.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\ntravelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.26795fc419a12ac32226be7f350e7cf2096763fe62c07363914d17d8b1ac8e56.json b/public/en.search-data.min.26795fc419a12ac32226be7f350e7cf2096763fe62c07363914d17d8b1ac8e56.json
new file mode 100644
index 0000000..f01251b
--- /dev/null
+++ b/public/en.search-data.min.26795fc419a12ac32226be7f350e7cf2096763fe62c07363914d17d8b1ac8e56.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":19,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.29602cad1fc3d0a6b21fe32f1fde21eec0b0505476aa0ee7cce39ce71cb8ab16.json b/public/en.search-data.min.29602cad1fc3d0a6b21fe32f1fde21eec0b0505476aa0ee7cce39ce71cb8ab16.json
new file mode 100644
index 0000000..41c98a1
--- /dev/null
+++ b/public/en.search-data.min.29602cad1fc3d0a6b21fe32f1fde21eec0b0505476aa0ee7cce39ce71cb8ab16.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":8,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":9,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":10,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":12,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":13,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":14,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":15,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":16,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":17,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":18,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":19,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.2fcc4604322f1c298722042c62acc0150432fc6de5d2a5d242641dad06adb3d2.json b/public/en.search-data.min.2fcc4604322f1c298722042c62acc0150432fc6de5d2a5d242641dad06adb3d2.json
new file mode 100644
index 0000000..22d10e7
--- /dev/null
+++ b/public/en.search-data.min.2fcc4604322f1c298722042c62acc0150432fc6de5d2a5d242641dad06adb3d2.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/reference-pages/autohome/","title":"Quickstart","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":3,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":4,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":5,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":7,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":8,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.304a294d6fdc89c7603281b295703c248a93d226a4caf7343d1b27f009eadaf5.json b/public/en.search-data.min.304a294d6fdc89c7603281b295703c248a93d226a4caf7343d1b27f009eadaf5.json
new file mode 100644
index 0000000..45392f5
--- /dev/null
+++ b/public/en.search-data.min.304a294d6fdc89c7603281b295703c248a93d226a4caf7343d1b27f009eadaf5.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.3647847fabb48778a5ad3e98493e2838298caf75461c71e11c85e70c64a9e60e.json b/public/en.search-data.min.3647847fabb48778a5ad3e98493e2838298caf75461c71e11c85e70c64a9e60e.json
new file mode 100644
index 0000000..53b91c4
--- /dev/null
+++ b/public/en.search-data.min.3647847fabb48778a5ad3e98493e2838298caf75461c71e11c85e70c64a9e60e.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":17,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":18,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.391017a502c7405bf4023c4b4bd23514324f48a3d4503df2789e1ee031fe8d90.json b/public/en.search-data.min.391017a502c7405bf4023c4b4bd23514324f48a3d4503df2789e1ee031fe8d90.json
new file mode 100644
index 0000000..5dcc35c
--- /dev/null
+++ b/public/en.search-data.min.391017a502c7405bf4023c4b4bd23514324f48a3d4503df2789e1ee031fe8d90.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":5,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":8,"href":"/docs/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":9,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":14,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":18,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":19,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":20,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":23,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":24,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.3e93869b101f92aca860e2afe0480bb2c84c4292d5bbddc6488b39aebc01fcc7.json b/public/en.search-data.min.3e93869b101f92aca860e2afe0480bb2c84c4292d5bbddc6488b39aebc01fcc7.json
new file mode 100644
index 0000000..3325feb
--- /dev/null
+++ b/public/en.search-data.min.3e93869b101f92aca860e2afe0480bb2c84c4292d5bbddc6488b39aebc01fcc7.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a coordinate.\nmoveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.445d8a4c1c2cfc514578b8de5e1a255447e5f3ed79c02231fa561f469d6fb4c0.json b/public/en.search-data.min.445d8a4c1c2cfc514578b8de5e1a255447e5f3ed79c02231fa561f469d6fb4c0.json
new file mode 100644
index 0000000..4c072e5
--- /dev/null
+++ b/public/en.search-data.min.445d8a4c1c2cfc514578b8de5e1a255447e5f3ed79c02231fa561f469d6fb4c0.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" Fab # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.45287d4bab40c91556d0ee400339d653f8b533533fac5465d32398e76b03b8b3.json b/public/en.search-data.min.45287d4bab40c91556d0ee400339d653f8b533533fac5465d32398e76b03b8b3.json
new file mode 100644
index 0000000..50f0b9f
--- /dev/null
+++ b/public/en.search-data.min.45287d4bab40c91556d0ee400339d653f8b533533fac5465d32398e76b03b8b3.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Firstname Lastname Savings Peter Griffin $100 Lois Griffin $150 Joe Swanson $300 Cleveland Brown $250 Fab # autoHome()\nAutohome the machine.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\ntravelTo()\nMove to an x,y,z position with a z-hop.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.4675156f2f815ac19439aba9887f4797c070e5b270ba38de6ccc3a4818affab8.json b/public/en.search-data.min.4675156f2f815ac19439aba9887f4797c070e5b270ba38de6ccc3a4818affab8.json
new file mode 100644
index 0000000..38afb29
--- /dev/null
+++ b/public/en.search-data.min.4675156f2f815ac19439aba9887f4797c070e5b270ba38de6ccc3a4818affab8.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":8,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":9,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":10,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":11,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":13,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":14,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":15,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":16,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":17,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":18,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":19,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":20,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.48cb37053681cb6970cb4fa9938e19c1d9e9a0feed8ca5eaea4bfc8a798ab026.json b/public/en.search-data.min.48cb37053681cb6970cb4fa9938e19c1d9e9a0feed8ca5eaea4bfc8a798ab026.json
new file mode 100644
index 0000000..3555302
--- /dev/null
+++ b/public/en.search-data.min.48cb37053681cb6970cb4fa9938e19c1d9e9a0feed8ca5eaea4bfc8a798ab026.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # | Header | Title | | Paragraph | Text |\nFab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.4cd73e6faf0a4832708bee25e9cee2e922f6b9acc960cead3e744a3d329e8035.json b/public/en.search-data.min.4cd73e6faf0a4832708bee25e9cee2e922f6b9acc960cead3e744a3d329e8035.json
new file mode 100644
index 0000000..71f9832
--- /dev/null
+++ b/public/en.search-data.min.4cd73e6faf0a4832708bee25e9cee2e922f6b9acc960cead3e744a3d329e8035.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":17,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":18,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.509c32f44d58feb440f3a80dbffc45f22f075676b5aa4026d1babde6cd5b9615.json b/public/en.search-data.min.509c32f44d58feb440f3a80dbffc45f22f075676b5aa4026d1babde6cd5b9615.json
new file mode 100644
index 0000000..fe5eef7
--- /dev/null
+++ b/public/en.search-data.min.509c32f44d58feb440f3a80dbffc45f22f075676b5aa4026d1babde6cd5b9615.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.55786e98b357d542b9a9f1ebdc64f3a9cef1bfa7e7b929136564bec7b8d38e13.json b/public/en.search-data.min.55786e98b357d542b9a9f1ebdc64f3a9cef1bfa7e7b929136564bec7b8d38e13.json
new file mode 100644
index 0000000..85b953f
--- /dev/null
+++ b/public/en.search-data.min.55786e98b357d542b9a9f1ebdc64f3a9cef1bfa7e7b929136564bec7b8d38e13.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nautoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.558a1fe6ec355ea263b1c72da9b076f4f30b599a70f896650925a0ff96716a34.json b/public/en.search-data.min.558a1fe6ec355ea263b1c72da9b076f4f30b599a70f896650925a0ff96716a34.json
new file mode 100644
index 0000000..87868c1
--- /dev/null
+++ b/public/en.search-data.min.558a1fe6ec355ea263b1c72da9b076f4f30b599a70f896650925a0ff96716a34.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.565be0a4658598fc23d864f16a924b0d9c2324950165061c798e944d6c336f53.json b/public/en.search-data.min.565be0a4658598fc23d864f16a924b0d9c2324950165061c798e944d6c336f53.json
new file mode 100644
index 0000000..f5231dc
--- /dev/null
+++ b/public/en.search-data.min.565be0a4658598fc23d864f16a924b0d9c2324950165061c798e944d6c336f53.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.5bf89274dab7957218d8709c907e0da8a8c5e52a0a535f6150bd2972fb74f744.json b/public/en.search-data.min.5bf89274dab7957218d8709c907e0da8a8c5e52a0a535f6150bd2972fb74f744.json
new file mode 100644
index 0000000..8c9840b
--- /dev/null
+++ b/public/en.search-data.min.5bf89274dab7957218d8709c907e0da8a8c5e52a0a535f6150bd2972fb74f744.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.5fa0a25113e01e3f1618a9614f0ef7fb9d331a4f03d4af45671d21e60b53678c.json b/public/en.search-data.min.5fa0a25113e01e3f1618a9614f0ef7fb9d331a4f03d4af45671d21e60b53678c.json
new file mode 100644
index 0000000..181bb71
--- /dev/null
+++ b/public/en.search-data.min.5fa0a25113e01e3f1618a9614f0ef7fb9d331a4f03d4af45671d21e60b53678c.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":7,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":8,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":9,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":11,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":15,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":16,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":17,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":18,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":19,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":20,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":21,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":22,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.5fc846aaf33df5a2c9bfbc26c1f95a12084d32e0442d5a1c8f6c398100923946.json b/public/en.search-data.min.5fc846aaf33df5a2c9bfbc26c1f95a12084d32e0442d5a1c8f6c398100923946.json
new file mode 100644
index 0000000..a390b92
--- /dev/null
+++ b/public/en.search-data.min.5fc846aaf33df5a2c9bfbc26c1f95a12084d32e0442d5a1c8f6c398100923946.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Header Title Paragraph Text Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.5ff007a54a084d92bf0714481a15343d45fc205cdcfe5f00647dc98c5d553336.json b/public/en.search-data.min.5ff007a54a084d92bf0714481a15343d45fc205cdcfe5f00647dc98c5d553336.json
new file mode 100644
index 0000000..8c480f2
--- /dev/null
+++ b/public/en.search-data.min.5ff007a54a084d92bf0714481a15343d45fc205cdcfe5f00647dc98c5d553336.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.60207e4f0aa5d2fad2003bbaabed610c01aabdf07db05aea4431ae292667aaad.json b/public/en.search-data.min.60207e4f0aa5d2fad2003bbaabed610c01aabdf07db05aea4431ae292667aaad.json
new file mode 100644
index 0000000..43f2cb8
--- /dev/null
+++ b/public/en.search-data.min.60207e4f0aa5d2fad2003bbaabed610c01aabdf07db05aea4431ae292667aaad.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nautoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.61d5e44622e0ab52daa1d875fd37dba3ff5f0c40dd4fb0c1c0ee9258275e496d.json b/public/en.search-data.min.61d5e44622e0ab52daa1d875fd37dba3ff5f0c40dd4fb0c1c0ee9258275e496d.json
new file mode 100644
index 0000000..9d3de8e
--- /dev/null
+++ b/public/en.search-data.min.61d5e44622e0ab52daa1d875fd37dba3ff5f0c40dd4fb0c1c0ee9258275e496d.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # _Commands related to movements _ moveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6445f0a0beb9c7f367316a2192ae26de3fb58161f9edddfc9c94620923320aa7.json b/public/en.search-data.min.6445f0a0beb9c7f367316a2192ae26de3fb58161f9edddfc9c94620923320aa7.json
new file mode 100644
index 0000000..ae56958
--- /dev/null
+++ b/public/en.search-data.min.6445f0a0beb9c7f367316a2192ae26de3fb58161f9edddfc9c94620923320aa7.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6499862a64d277340e205c881fe65582ab1f36f9eefc09396ef53bdac0d7317b.json b/public/en.search-data.min.6499862a64d277340e205c881fe65582ab1f36f9eefc09396ef53bdac0d7317b.json
new file mode 100644
index 0000000..ba60aec
--- /dev/null
+++ b/public/en.search-data.min.6499862a64d277340e205c881fe65582ab1f36f9eefc09396ef53bdac0d7317b.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6546c45c925b5659b8d98ca778e860d2f02ad8c70b75ee5864ded5adc3a67fa9.json b/public/en.search-data.min.6546c45c925b5659b8d98ca778e860d2f02ad8c70b75ee5864ded5adc3a67fa9.json
new file mode 100644
index 0000000..ccbf1b0
--- /dev/null
+++ b/public/en.search-data.min.6546c45c925b5659b8d98ca778e860d2f02ad8c70b75ee5864ded5adc3a67fa9.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setEAbsolute() Set extruder axis to absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6577178d88c8978f5ae22e93c7dcb991bb5ac3970dfe6ecc444bdb7ac39e22d0.json b/public/en.search-data.min.6577178d88c8978f5ae22e93c7dcb991bb5ac3970dfe6ecc444bdb7ac39e22d0.json
new file mode 100644
index 0000000..14f60df
--- /dev/null
+++ b/public/en.search-data.min.6577178d88c8978f5ae22e93c7dcb991bb5ac3970dfe6ecc444bdb7ac39e22d0.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.65d015c500b7ca4aa2427d4f8051a29a701136efbc50403977ab87f648665f45.json b/public/en.search-data.min.65d015c500b7ca4aa2427d4f8051a29a701136efbc50403977ab87f648665f45.json
new file mode 100644
index 0000000..8d2bc3d
--- /dev/null
+++ b/public/en.search-data.min.65d015c500b7ca4aa2427d4f8051a29a701136efbc50403977ab87f648665f45.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements moveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.667e964f283eef6242dccb5942251655146e4b0cb5e259b0803857931ce18cee.json b/public/en.search-data.min.667e964f283eef6242dccb5942251655146e4b0cb5e259b0803857931ce18cee.json
new file mode 100644
index 0000000..060047f
--- /dev/null
+++ b/public/en.search-data.min.667e964f283eef6242dccb5942251655146e4b0cb5e259b0803857931ce18cee.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":7,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":8,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":9,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":10,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":11,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":12,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.66c5937d497e0ccf53cbc616e18b843aa5f4347ba038182bf0293ad11fa91ccb.json b/public/en.search-data.min.66c5937d497e0ccf53cbc616e18b843aa5f4347ba038182bf0293ad11fa91ccb.json
new file mode 100644
index 0000000..b02488c
--- /dev/null
+++ b/public/en.search-data.min.66c5937d497e0ccf53cbc616e18b843aa5f4347ba038182bf0293ad11fa91ccb.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. Use absolute coordinates. "},{"id":4,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position Xyz","section":"Reference","content":"to come\n"},{"id":5,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":6,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":8,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":9,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":11,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":12,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":13,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":15,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":22,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":23,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that behaviour differs depending on firmware. For example, G90 on Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions seperately, see setAbsolutePositionXYZ().\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6a61eb24f5e6c6205b4947d8d855387a9c63d0dae18887b9b660fdd40fe6bf90.json b/public/en.search-data.min.6a61eb24f5e6c6205b4947d8d855387a9c63d0dae18887b9b660fdd40fe6bf90.json
new file mode 100644
index 0000000..7548f61
--- /dev/null
+++ b/public/en.search-data.min.6a61eb24f5e6c6205b4947d8d855387a9c63d0dae18887b9b660fdd40fe6bf90.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6af851c1ac65c501a9485c83928656edca91be2fec79d3d2492fb610fcee29c0.json b/public/en.search-data.min.6af851c1ac65c501a9485c83928656edca91be2fec79d3d2492fb610fcee29c0.json
new file mode 100644
index 0000000..adc4cbd
--- /dev/null
+++ b/public/en.search-data.min.6af851c1ac65c501a9485c83928656edca91be2fec79d3d2492fb610fcee29c0.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6b6b2b9842106379ea9ce4b07549d219663514e6bd370d1fefb6cc4003665bfb.json b/public/en.search-data.min.6b6b2b9842106379ea9ce4b07549d219663514e6bd370d1fefb6cc4003665bfb.json
new file mode 100644
index 0000000..9ad43e8
--- /dev/null
+++ b/public/en.search-data.min.6b6b2b9842106379ea9ce4b07549d219663514e6bd370d1fefb6cc4003665bfb.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement. autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6bd8dd9b711b40d5bcda4fab6fecc6369b593e82312eb8deb610820805be14ad.json b/public/en.search-data.min.6bd8dd9b711b40d5bcda4fab6fecc6369b593e82312eb8deb610820805be14ad.json
new file mode 100644
index 0000000..89ea60c
--- /dev/null
+++ b/public/en.search-data.min.6bd8dd9b711b40d5bcda4fab6fecc6369b593e82312eb8deb610820805be14ad.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":19,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.6da35d1b7873a492a19a63b1a6d7a866eb1c69bcd4db0c41f91422935ef10597.json b/public/en.search-data.min.6da35d1b7873a492a19a63b1a6d7a866eb1c69bcd4db0c41f91422935ef10597.json
new file mode 100644
index 0000000..0b6a655
--- /dev/null
+++ b/public/en.search-data.min.6da35d1b7873a492a19a63b1a6d7a866eb1c69bcd4db0c41f91422935ef10597.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":3,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":4,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":5,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":7,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":8,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. Karen Web performance 36 {{/* template for adding new doc items */}} \u0026lt;tr\u0026gt; \u0026lt;td\u0026gt; \u0026lt;/td\u0026gt; \u0026lt;td\u0026gt; \u0026lt;/td\u0026gt; \u0026lt;td\u0026gt; \u0026lt;/td\u0026gt; \u0026lt;/tr\u0026gt; moveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"},{"id":11,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":12,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":13,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":15,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.7128648673136f428e4e08e8623df06e4c5452a789b703f2415781ec9f13e036.json b/public/en.search-data.min.7128648673136f428e4e08e8623df06e4c5452a789b703f2415781ec9f13e036.json
new file mode 100644
index 0000000..7fea8a5
--- /dev/null
+++ b/public/en.search-data.min.7128648673136f428e4e08e8623df06e4c5452a789b703f2415781ec9f13e036.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.718e03783f5efc75bbb2edadb7d0244fe0660f2c3c34d47689a4817cbc1c5277.json b/public/en.search-data.min.718e03783f5efc75bbb2edadb7d0244fe0660f2c3c34d47689a4817cbc1c5277.json
new file mode 100644
index 0000000..31abfac
--- /dev/null
+++ b/public/en.search-data.min.718e03783f5efc75bbb2edadb7d0244fe0660f2c3c34d47689a4817cbc1c5277.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position Xyz","section":"Reference","content":"to come\n"},{"id":5,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":6,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":8,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":9,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":11,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":12,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":13,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":15,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":22,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":23,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.71e69686733f1371040b0e096c71646444c02394a04d1f3d5cbd08dd169ed98c.json b/public/en.search-data.min.71e69686733f1371040b0e096c71646444c02394a04d1f3d5cbd08dd169ed98c.json
new file mode 100644
index 0000000..c0fe197
--- /dev/null
+++ b/public/en.search-data.min.71e69686733f1371040b0e096c71646444c02394a04d1f3d5cbd08dd169ed98c.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":17,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.7337c013d8f9b84d3b7fd99a0f53f1c23dd63f493ee6aec2551998b717186cee.json b/public/en.search-data.min.7337c013d8f9b84d3b7fd99a0f53f1c23dd63f493ee6aec2551998b717186cee.json
new file mode 100644
index 0000000..f54ceed
--- /dev/null
+++ b/public/en.search-data.min.7337c013d8f9b84d3b7fd99a0f53f1c23dd63f493ee6aec2551998b717186cee.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.7375df6b62db53129f7a7d4733d0976a055f0ed41df653a39a82859938ffde6f.json b/public/en.search-data.min.7375df6b62db53129f7a7d4733d0976a055f0ed41df653a39a82859938ffde6f.json
new file mode 100644
index 0000000..27b2aa1
--- /dev/null
+++ b/public/en.search-data.min.7375df6b62db53129f7a7d4733d0976a055f0ed41df653a39a82859938ffde6f.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.73fde574b66c5a1ae260c1ff8cab0161cab328c29957a53f4f0eded5b20e2dbd.json b/public/en.search-data.min.73fde574b66c5a1ae260c1ff8cab0161cab328c29957a53f4f0eded5b20e2dbd.json
new file mode 100644
index 0000000..6711884
--- /dev/null
+++ b/public/en.search-data.min.73fde574b66c5a1ae260c1ff8cab0161cab328c29957a53f4f0eded5b20e2dbd.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # autoHome()\nAutohome the machine. Griffin $100 Lois Griffin $150 Joe Swanson $300 Cleveland Brown $250 Fab # moveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\ntravelTo()\nMove to an x,y,z position with a z-hop.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.772214b603eccaf257495902ca09daa59bc1f8db14bf27672640d0ba4b0a5637.json b/public/en.search-data.min.772214b603eccaf257495902ca09daa59bc1f8db14bf27672640d0ba4b0a5637.json
new file mode 100644
index 0000000..4210e6c
--- /dev/null
+++ b/public/en.search-data.min.772214b603eccaf257495902ca09daa59bc1f8db14bf27672640d0ba4b0a5637.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position Xyz","section":"Reference","content":"to come\n"},{"id":5,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":6,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":8,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":9,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":11,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":12,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":13,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":15,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":22,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":23,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that behaviour differs depending on firmware. For example, G90 on Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions seperately, see setAbsolutePositionXYZ().\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.7830d52e2f16f74b9b7c45522763a41e206663e7aeb268e1ffe69f1610e3a6c4.json b/public/en.search-data.min.7830d52e2f16f74b9b7c45522763a41e206663e7aeb268e1ffe69f1610e3a6c4.json
new file mode 100644
index 0000000..4a0581d
--- /dev/null
+++ b/public/en.search-data.min.7830d52e2f16f74b9b7c45522763a41e206663e7aeb268e1ffe69f1610e3a6c4.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":5,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":8,"href":"/docs/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":9,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":13,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":17,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":18,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":19,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":20,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":21,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":22,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":23,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.79ff799fcc7040c6b45c0e3ec2374f07bec15ba12622a7a3c0ca79b37b4e00fa.json b/public/en.search-data.min.79ff799fcc7040c6b45c0e3ec2374f07bec15ba12622a7a3c0ca79b37b4e00fa.json
new file mode 100644
index 0000000..64136e2
--- /dev/null
+++ b/public/en.search-data.min.79ff799fcc7040c6b45c0e3ec2374f07bec15ba12622a7a3c0ca79b37b4e00fa.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.7d9dd6105ae5375618d9d0241abf45e8c1dd525876f5df2f217a332e7b698b01.json b/public/en.search-data.min.7d9dd6105ae5375618d9d0241abf45e8c1dd525876f5df2f217a332e7b698b01.json
new file mode 100644
index 0000000..fb80ace
--- /dev/null
+++ b/public/en.search-data.min.7d9dd6105ae5375618d9d0241abf45e8c1dd525876f5df2f217a332e7b698b01.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.7e95d980c3282e4b0be2b9adec314ebd13db1bc4a0ed4a1da8af101c8f211c29.json b/public/en.search-data.min.7e95d980c3282e4b0be2b9adec314ebd13db1bc4a0ed4a1da8af101c8f211c29.json
new file mode 100644
index 0000000..51da7fe
--- /dev/null
+++ b/public/en.search-data.min.7e95d980c3282e4b0be2b9adec314ebd13db1bc4a0ed4a1da8af101c8f211c29.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # autoHome()\nAutohome the machine. Title Paragraph Text Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.7f321d667fb9e48f584f17ac1e71faba6cd7df99151431b63318e328cafbffd8.json b/public/en.search-data.min.7f321d667fb9e48f584f17ac1e71faba6cd7df99151431b63318e328cafbffd8.json
new file mode 100644
index 0000000..fad7d26
--- /dev/null
+++ b/public/en.search-data.min.7f321d667fb9e48f584f17ac1e71faba6cd7df99151431b63318e328cafbffd8.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # | \u0026mdash;\u0026mdash;\u0026mdash;\u0026ndash; | \u0026mdash;\u0026mdash;\u0026mdash;\u0026ndash; | | Header | Title | | Paragraph | Text |\nFab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.801a6a757cd9a4a9499d57cffe098df09a4a43689412b4091368c64f1b9ea204.json b/public/en.search-data.min.801a6a757cd9a4a9499d57cffe098df09a4a43689412b4091368c64f1b9ea204.json
new file mode 100644
index 0000000..82eedd3
--- /dev/null
+++ b/public/en.search-data.min.801a6a757cd9a4a9499d57cffe098df09a4a43689412b4091368c64f1b9ea204.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":3,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":4,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":5,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":7,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":8,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Chris HTML tables 22 Dennis Web accessibility 45 Sarah JavaScript frameworks 29 Karen Web performance 36 Average age 33 Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"},{"id":11,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":12,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":13,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":15,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.81905bc2c4cd8c52929d625a6633dbf5be644a50ef023e6ed6d8403bb0e3af8f.json b/public/en.search-data.min.81905bc2c4cd8c52929d625a6633dbf5be644a50ef023e6ed6d8403bb0e3af8f.json
new file mode 100644
index 0000000..2268bca
--- /dev/null
+++ b/public/en.search-data.min.81905bc2c4cd8c52929d625a6633dbf5be644a50ef023e6ed6d8403bb0e3af8f.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":18,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":19,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.83c0aed0d8ecb36136e091e4caa0b03bd83d734aaa6dabe48149f256251d788b.json b/public/en.search-data.min.83c0aed0d8ecb36136e091e4caa0b03bd83d734aaa6dabe48149f256251d788b.json
new file mode 100644
index 0000000..77e96b0
--- /dev/null
+++ b/public/en.search-data.min.83c0aed0d8ecb36136e091e4caa0b03bd83d734aaa6dabe48149f256251d788b.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsettNozzleT()\nSet nozzle temperature.\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.860e6fe1a873ebe98edd5b07f77b615f4f8d5b8281b6fc1c2a3c7cb4044fbf8a.json b/public/en.search-data.min.860e6fe1a873ebe98edd5b07f77b615f4f8d5b8281b6fc1c2a3c7cb4044fbf8a.json
new file mode 100644
index 0000000..84d6611
--- /dev/null
+++ b/public/en.search-data.min.860e6fe1a873ebe98edd5b07f77b615f4f8d5b8281b6fc1c2a3c7cb4044fbf8a.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":17,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.861af178428f7141bab3f1ad83c730053f4c81847dcb660ad19e42c63c9a444c.json b/public/en.search-data.min.861af178428f7141bab3f1ad83c730053f4c81847dcb660ad19e42c63c9a444c.json
new file mode 100644
index 0000000..46bcdd2
--- /dev/null
+++ b/public/en.search-data.min.861af178428f7141bab3f1ad83c730053f4c81847dcb660ad19e42c63c9a444c.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.86ecc0111a008bff2b6a31dc9f682dd09dc094acf6ded34e0942911f94a080b1.json b/public/en.search-data.min.86ecc0111a008bff2b6a31dc9f682dd09dc094acf6ded34e0942911f94a080b1.json
new file mode 100644
index 0000000..a5ea4cc
--- /dev/null
+++ b/public/en.search-data.min.86ecc0111a008bff2b6a31dc9f682dd09dc094acf6ded34e0942911f94a080b1.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.8849d2cacdbcf52d9292b8c6db6763134c296638d2450011a7cad46facae1b7e.json b/public/en.search-data.min.8849d2cacdbcf52d9292b8c6db6763134c296638d2450011a7cad46facae1b7e.json
new file mode 100644
index 0000000..3fab382
--- /dev/null
+++ b/public/en.search-data.min.8849d2cacdbcf52d9292b8c6db6763134c296638d2450011a7cad46facae1b7e.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"},{"id":10,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":11,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":12,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":18,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.894e3518b4efd7e1b26bca6ecc152fa01a89ed8be9a761723befcefe87497135.json b/public/en.search-data.min.894e3518b4efd7e1b26bca6ecc152fa01a89ed8be9a761723befcefe87497135.json
new file mode 100644
index 0000000..5696cc3
--- /dev/null
+++ b/public/en.search-data.min.894e3518b4efd7e1b26bca6ecc152fa01a89ed8be9a761723befcefe87497135.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.89c0d4264a9e860a6c4cb0d8a0e8840ce657e3d0cd963becc81d1d5448c3c030.json b/public/en.search-data.min.89c0d4264a9e860a6c4cb0d8a0e8840ce657e3d0cd963becc81d1d5448c3c030.json
new file mode 100644
index 0000000..f7d08bf
--- /dev/null
+++ b/public/en.search-data.min.89c0d4264a9e860a6c4cb0d8a0e8840ce657e3d0cd963becc81d1d5448c3c030.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Peter Griffin $100 Lois Griffin $150 Joe Swanson $300 Cleveland Brown $250 Fab # autoHome()\nAutohome the machine.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\ntravelTo()\nMove to an x,y,z position with a z-hop.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.8c19a39b7953525530ca513578ac8304dfb364dca417ba356000e0c617c0eb2a.json b/public/en.search-data.min.8c19a39b7953525530ca513578ac8304dfb364dca417ba356000e0c617c0eb2a.json
new file mode 100644
index 0000000..4728ac0
--- /dev/null
+++ b/public/en.search-data.min.8c19a39b7953525530ca513578ac8304dfb364dca417ba356000e0c617c0eb2a.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.91fd0cbad6736a636b94cfca254e3a815f6627e00d11557be52a99e5b1a44231.json b/public/en.search-data.min.91fd0cbad6736a636b94cfca254e3a815f6627e00d11557be52a99e5b1a44231.json
new file mode 100644
index 0000000..bf98a1d
--- /dev/null
+++ b/public/en.search-data.min.91fd0cbad6736a636b94cfca254e3a815f6627e00d11557be52a99e5b1a44231.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.94968468ff8b46624548373c43591a7a34c3906249e666635e5e5712bc39b4cd.json b/public/en.search-data.min.94968468ff8b46624548373c43591a7a34c3906249e666635e5e5712bc39b4cd.json
new file mode 100644
index 0000000..1b6648a
--- /dev/null
+++ b/public/en.search-data.min.94968468ff8b46624548373c43591a7a34c3906249e666635e5e5712bc39b4cd.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.96a560e13c0e945062164a0eede07db68559e25265ea9a4daeced86b305b711f.json b/public/en.search-data.min.96a560e13c0e945062164a0eede07db68559e25265ea9a4daeced86b305b711f.json
new file mode 100644
index 0000000..c985f46
--- /dev/null
+++ b/public/en.search-data.min.96a560e13c0e945062164a0eede07db68559e25265ea9a4daeced86b305b711f.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.97b0bb8f87c4d1219d3160d213583251311b144cea0763e2283cf364553113f2.json b/public/en.search-data.min.97b0bb8f87c4d1219d3160d213583251311b144cea0763e2283cf364553113f2.json
new file mode 100644
index 0000000..725d597
--- /dev/null
+++ b/public/en.search-data.min.97b0bb8f87c4d1219d3160d213583251311b144cea0763e2283cf364553113f2.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":17,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":18,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.981a159b15887545282b1b960b4b0a1e5ae1ce30723a81e6e9cd45328ea1d46c.json b/public/en.search-data.min.981a159b15887545282b1b960b4b0a1e5ae1ce30723a81e6e9cd45328ea1d46c.json
new file mode 100644
index 0000000..07f47e3
--- /dev/null
+++ b/public/en.search-data.min.981a159b15887545282b1b960b4b0a1e5ae1ce30723a81e6e9cd45328ea1d46c.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setEAbsolute() Set extruder axis to absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.98bbde77c8be30b70ea2b56f6142d73640d8cd5c773fc19c26f15900f321438d.json b/public/en.search-data.min.98bbde77c8be30b70ea2b56f6142d73640d8cd5c773fc19c26f15900f321438d.json
new file mode 100644
index 0000000..1ef9bf1
--- /dev/null
+++ b/public/en.search-data.min.98bbde77c8be30b70ea2b56f6142d73640d8cd5c773fc19c26f15900f321438d.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveE()\nMove to an x,y,z position with a z-hop.\ntravelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.9a42dad56111450c33e67bcedc9fdde765cd64ce3d49651e2b9b9bc9959b1f61.json b/public/en.search-data.min.9a42dad56111450c33e67bcedc9fdde765cd64ce3d49651e2b9b9bc9959b1f61.json
new file mode 100644
index 0000000..1ceeb28
--- /dev/null
+++ b/public/en.search-data.min.9a42dad56111450c33e67bcedc9fdde765cd64ce3d49651e2b9b9bc9959b1f61.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine. Note that Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.9c75bba4a8ea5c57659bb7bef01fbb932f699ea27e97f71802fb46e2b7fc0b07.json b/public/en.search-data.min.9c75bba4a8ea5c57659bb7bef01fbb932f699ea27e97f71802fb46e2b7fc0b07.json
new file mode 100644
index 0000000..c9596b6
--- /dev/null
+++ b/public/en.search-data.min.9c75bba4a8ea5c57659bb7bef01fbb932f699ea27e97f71802fb46e2b7fc0b07.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to a point.\nmoveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.a0545dae98cbf4cecedf3878fd3fa830b28f77cf9efd8699e84043162133b030.json b/public/en.search-data.min.a0545dae98cbf4cecedf3878fd3fa830b28f77cf9efd8699e84043162133b030.json
new file mode 100644
index 0000000..e4c7f5d
--- /dev/null
+++ b/public/en.search-data.min.a0545dae98cbf4cecedf3878fd3fa830b28f77cf9efd8699e84043162133b030.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":8,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":9,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":11,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":12,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":13,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":14,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":15,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":16,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":17,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":18,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":24,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.a2f9a6f5c36a7330722b76867f3413a4eefd34aa3bfa41259825737e2d5b9566.json b/public/en.search-data.min.a2f9a6f5c36a7330722b76867f3413a4eefd34aa3bfa41259825737e2d5b9566.json
new file mode 100644
index 0000000..98dca42
--- /dev/null
+++ b/public/en.search-data.min.a2f9a6f5c36a7330722b76867f3413a4eefd34aa3bfa41259825737e2d5b9566.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # autoHome() Autohome the machine. Title Paragraph Text Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.a38bacd2505c23ef42f1f9abd28ed86f95ac0dff3da3ea7a7c40e461bec826e0.json b/public/en.search-data.min.a38bacd2505c23ef42f1f9abd28ed86f95ac0dff3da3ea7a7c40e461bec826e0.json
new file mode 100644
index 0000000..3b48a0b
--- /dev/null
+++ b/public/en.search-data.min.a38bacd2505c23ef42f1f9abd28ed86f95ac0dff3da3ea7a7c40e461bec826e0.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.a406ce662dabdb1249a9fb4a1a02502ffb38b06e0a460e7a2f082cfedfe90af2.json b/public/en.search-data.min.a406ce662dabdb1249a9fb4a1a02502ffb38b06e0a460e7a2f082cfedfe90af2.json
new file mode 100644
index 0000000..1a581c2
--- /dev/null
+++ b/public/en.search-data.min.a406ce662dabdb1249a9fb4a1a02502ffb38b06e0a460e7a2f082cfedfe90af2.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":2,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":3,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":4,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":8,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":9,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":14,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":18,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":19,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":20,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":23,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":24,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.a8a9e17cca1b7fb9a055d3771c1fe3d65160bfc63090e47f3c1c06ec3746066f.json b/public/en.search-data.min.a8a9e17cca1b7fb9a055d3771c1fe3d65160bfc63090e47f3c1c06ec3746066f.json
new file mode 100644
index 0000000..5d4905a
--- /dev/null
+++ b/public/en.search-data.min.a8a9e17cca1b7fb9a055d3771c1fe3d65160bfc63090e47f3c1c06ec3746066f.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":17,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":18,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmoveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.ab470f4d6d2e6dc40dbb80009279282d69a20863acd3c536e7a03dc912bc3b9c.json b/public/en.search-data.min.ab470f4d6d2e6dc40dbb80009279282d69a20863acd3c536e7a03dc912bc3b9c.json
new file mode 100644
index 0000000..c148406
--- /dev/null
+++ b/public/en.search-data.min.ab470f4d6d2e6dc40dbb80009279282d69a20863acd3c536e7a03dc912bc3b9c.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":8,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":9,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":10,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":11,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":12,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":13,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":14,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":15,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":21,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.abe4ddbf007062948fa99a7be7a45bd457430d82fce36d01b81d3b26ad8de96d.json b/public/en.search-data.min.abe4ddbf007062948fa99a7be7a45bd457430d82fce36d01b81d3b26ad8de96d.json
new file mode 100644
index 0000000..54ea13a
--- /dev/null
+++ b/public/en.search-data.min.abe4ddbf007062948fa99a7be7a45bd457430d82fce36d01b81d3b26ad8de96d.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nGCodes # autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.b22d38864b7bb570f898add170d5d604d0802cceec1e58355361d744d59891d6.json b/public/en.search-data.min.b22d38864b7bb570f898add170d5d604d0802cceec1e58355361d744d59891d6.json
new file mode 100644
index 0000000..3880635
--- /dev/null
+++ b/public/en.search-data.min.b22d38864b7bb570f898add170d5d604d0802cceec1e58355361d744d59891d6.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":8,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":9,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":10,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":11,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":14,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":15,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":16,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":17,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":18,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":19,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":20,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":21,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.b25c9a14aa028cd957e5f64d43b8ee801354d45cc5867530a965c6dcda605ebf.json b/public/en.search-data.min.b25c9a14aa028cd957e5f64d43b8ee801354d45cc5867530a965c6dcda605ebf.json
new file mode 100644
index 0000000..8fc72fa
--- /dev/null
+++ b/public/en.search-data.min.b25c9a14aa028cd957e5f64d43b8ee801354d45cc5867530a965c6dcda605ebf.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":6,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":7,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":8,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":9,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":10,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":11,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.b3397ef9eef083de5eb7c1237cab9a101c29b65506def9dbcb2c9419d4600a95.json b/public/en.search-data.min.b3397ef9eef083de5eb7c1237cab9a101c29b65506def9dbcb2c9419d4600a95.json
new file mode 100644
index 0000000..0392554
--- /dev/null
+++ b/public/en.search-data.min.b3397ef9eef083de5eb7c1237cab9a101c29b65506def9dbcb2c9419d4600a95.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Syntax Description Header Title Paragraph Text Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.b7c7a96f8d3894b028594db37e5f6ad4465953a6469ea180e4ef2c8c8cbd8ae2.json b/public/en.search-data.min.b7c7a96f8d3894b028594db37e5f6ad4465953a6469ea180e4ef2c8c8cbd8ae2.json
new file mode 100644
index 0000000..063a6c8
--- /dev/null
+++ b/public/en.search-data.min.b7c7a96f8d3894b028594db37e5f6ad4465953a6469ea180e4ef2c8c8cbd8ae2.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.b86107c2283ccf4dcc7c1c084d4b0da505310b8bc00c5d213273b3e64b8a82c6.json b/public/en.search-data.min.b86107c2283ccf4dcc7c1c084d4b0da505310b8bc00c5d213273b3e64b8a82c6.json
new file mode 100644
index 0000000..ca00de0
--- /dev/null
+++ b/public/en.search-data.min.b86107c2283ccf4dcc7c1c084d4b0da505310b8bc00c5d213273b3e64b8a82c6.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":8,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":9,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":10,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":11,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":12,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":13,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":14,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":15,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":16,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":17,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":23,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.b8694d7f275c2bf95c26f68f7835d3df004cd5467cd751f7325ec7664324a5b8.json b/public/en.search-data.min.b8694d7f275c2bf95c26f68f7835d3df004cd5467cd751f7325ec7664324a5b8.json
new file mode 100644
index 0000000..107b8d8
--- /dev/null
+++ b/public/en.search-data.min.b8694d7f275c2bf95c26f68f7835d3df004cd5467cd751f7325ec7664324a5b8.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":8,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":9,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":10,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":11,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":12,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":13,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":14,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":15,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":16,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":22,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bad9fe840129bc1af5af801d913f6e4571b96d65a99e8f22c84a185c8b2cb035.json b/public/en.search-data.min.bad9fe840129bc1af5af801d913f6e4571b96d65a99e8f22c84a185c8b2cb035.json
new file mode 100644
index 0000000..161f28c
--- /dev/null
+++ b/public/en.search-data.min.bad9fe840129bc1af5af801d913f6e4571b96d65a99e8f22c84a185c8b2cb035.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bba190c71a3a3ce31d639c79c1fa94ff070e7d5643793d3b6875fb107ff215e3.json b/public/en.search-data.min.bba190c71a3a3ce31d639c79c1fa94ff070e7d5643793d3b6875fb107ff215e3.json
new file mode 100644
index 0000000..9d6a968
--- /dev/null
+++ b/public/en.search-data.min.bba190c71a3a3ce31d639c79c1fa94ff070e7d5643793d3b6875fb107ff215e3.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bbc5e819b180288b63890162d58d58553187d1fa7d90555abe3b69363269277b.json b/public/en.search-data.min.bbc5e819b180288b63890162d58d58553187d1fa7d90555abe3b69363269277b.json
new file mode 100644
index 0000000..eccd3eb
--- /dev/null
+++ b/public/en.search-data.min.bbc5e819b180288b63890162d58d58553187d1fa7d90555abe3b69363269277b.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bbc9f13e84fb2a17ce054c9d6dda33f30d41b11a84c7dfd7479e58999931f39f.json b/public/en.search-data.min.bbc9f13e84fb2a17ce054c9d6dda33f30d41b11a84c7dfd7479e58999931f39f.json
new file mode 100644
index 0000000..9cd85df
--- /dev/null
+++ b/public/en.search-data.min.bbc9f13e84fb2a17ce054c9d6dda33f30d41b11a84c7dfd7479e58999931f39f.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bf0a000c9c7900b4bbb10dd12183db31d89992a82f52bbfbd3f79483047786d1.json b/public/en.search-data.min.bf0a000c9c7900b4bbb10dd12183db31d89992a82f52bbfbd3f79483047786d1.json
new file mode 100644
index 0000000..1e13636
--- /dev/null
+++ b/public/en.search-data.min.bf0a000c9c7900b4bbb10dd12183db31d89992a82f52bbfbd3f79483047786d1.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bf22df4eaf43889158756edc9fc7e00ff81fd4ab33add9c82975300375f2a593.json b/public/en.search-data.min.bf22df4eaf43889158756edc9fc7e00ff81fd4ab33add9c82975300375f2a593.json
new file mode 100644
index 0000000..b71ea84
--- /dev/null
+++ b/public/en.search-data.min.bf22df4eaf43889158756edc9fc7e00ff81fd4ab33add9c82975300375f2a593.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bf76fe20f9f42249feacb637fc7dd0e32c62bc43b08e4db4f825ce94b0cfd608.json b/public/en.search-data.min.bf76fe20f9f42249feacb637fc7dd0e32c62bc43b08e4db4f825ce94b0cfd608.json
new file mode 100644
index 0000000..e7b6eea
--- /dev/null
+++ b/public/en.search-data.min.bf76fe20f9f42249feacb637fc7dd0e32c62bc43b08e4db4f825ce94b0cfd608.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.bf7d16b96ff0e16e63078f2958be1be6badfd87c89aebb5e209c17ae29497a67.json b/public/en.search-data.min.bf7d16b96ff0e16e63078f2958be1be6badfd87c89aebb5e209c17ae29497a67.json
new file mode 100644
index 0000000..04150f1
--- /dev/null
+++ b/public/en.search-data.min.bf7d16b96ff0e16e63078f2958be1be6badfd87c89aebb5e209c17ae29497a67.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c00e23b94e00aef0ef43af7fddf4b6251be839876c1a0db228a0617d6ec5f446.json b/public/en.search-data.min.c00e23b94e00aef0ef43af7fddf4b6251be839876c1a0db228a0617d6ec5f446.json
new file mode 100644
index 0000000..049c87a
--- /dev/null
+++ b/public/en.search-data.min.c00e23b94e00aef0ef43af7fddf4b6251be839876c1a0db228a0617d6ec5f446.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, (i.e. relative to the origin of the machine). Note that Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c0bc7529c23a3bec1b623fb2de6635ceec6db987683d966ca13e6f16263b49ae.json b/public/en.search-data.min.c0bc7529c23a3bec1b623fb2de6635ceec6db987683d966ca13e6f16263b49ae.json
new file mode 100644
index 0000000..130dde5
--- /dev/null
+++ b/public/en.search-data.min.c0bc7529c23a3bec1b623fb2de6635ceec6db987683d966ca13e6f16263b49ae.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c111c7ac0d90a67c67b55c838b974c84f29c50bee03187afe1288aab7e21ead7.json b/public/en.search-data.min.c111c7ac0d90a67c67b55c838b974c84f29c50bee03187afe1288aab7e21ead7.json
new file mode 100644
index 0000000..eb62520
--- /dev/null
+++ b/public/en.search-data.min.c111c7ac0d90a67c67b55c838b974c84f29c50bee03187afe1288aab7e21ead7.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":5,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":8,"href":"/docs/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":9,"href":"/docs/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":15,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":17,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":19,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":20,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":21,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":22,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":23,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":24,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c225043b57c5852126722f2f3e68ac819e50499408f143203e44e3d42c1cd049.json b/public/en.search-data.min.c225043b57c5852126722f2f3e68ac819e50499408f143203e44e3d42c1cd049.json
new file mode 100644
index 0000000..8537c18
--- /dev/null
+++ b/public/en.search-data.min.c225043b57c5852126722f2f3e68ac819e50499408f143203e44e3d42c1cd049.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZasdf()\nUse absolute coordinates for dimensional axes. setEAbsolute()\nUse absolute coordinates for extruder position. setEAbsolute()\nUse relative coordinates for extruder position. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c2d89b39a47110b577bde5ec2da55d97a8e04cfc34b38e31dcda5c5bf08baed3.json b/public/en.search-data.min.c2d89b39a47110b577bde5ec2da55d97a8e04cfc34b38e31dcda5c5bf08baed3.json
new file mode 100644
index 0000000..fbd9634
--- /dev/null
+++ b/public/en.search-data.min.c2d89b39a47110b577bde5ec2da55d97a8e04cfc34b38e31dcda5c5bf08baed3.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. setEAbsolute()\nUse absolute coordinates for extruder position. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c2f86be8bf35861faf90fe2214bb523b50b018784c4d43d3b19640c6721f8968.json b/public/en.search-data.min.c2f86be8bf35861faf90fe2214bb523b50b018784c4d43d3b19640c6721f8968.json
new file mode 100644
index 0000000..1301176
--- /dev/null
+++ b/public/en.search-data.min.c2f86be8bf35861faf90fe2214bb523b50b018784c4d43d3b19640c6721f8968.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":19,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c47141e51cf0062faf101fb98b697b8d9c5bfdcedf2aaaf965c1e57d06953df8.json b/public/en.search-data.min.c47141e51cf0062faf101fb98b697b8d9c5bfdcedf2aaaf965c1e57d06953df8.json
new file mode 100644
index 0000000..eb102fe
--- /dev/null
+++ b/public/en.search-data.min.c47141e51cf0062faf101fb98b697b8d9c5bfdcedf2aaaf965c1e57d06953df8.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" Autohome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nautoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c4a49f772fe1c88f3394a5761bcc3b6433a46cc0a8709d3ace6f55fbf48b6a32.json b/public/en.search-data.min.c4a49f772fe1c88f3394a5761bcc3b6433a46cc0a8709d3ace6f55fbf48b6a32.json
new file mode 100644
index 0000000..0a65f0c
--- /dev/null
+++ b/public/en.search-data.min.c4a49f772fe1c88f3394a5761bcc3b6433a46cc0a8709d3ace6f55fbf48b6a32.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\ntravelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c59b621fa81c9a3047dc1dfc53456d494adea3c6fdee8ceef49f1ae80c8dc306.json b/public/en.search-data.min.c59b621fa81c9a3047dc1dfc53456d494adea3c6fdee8ceef49f1ae80c8dc306.json
new file mode 100644
index 0000000..1fa5464
--- /dev/null
+++ b/public/en.search-data.min.c59b621fa81c9a3047dc1dfc53456d494adea3c6fdee8ceef49f1ae80c8dc306.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c88788fee0bbc6f8d202ce2ad9652258561894883a4c2b22dae8ddae27595333.json b/public/en.search-data.min.c88788fee0bbc6f8d202ce2ad9652258561894883a4c2b22dae8ddae27595333.json
new file mode 100644
index 0000000..d63d18d
--- /dev/null
+++ b/public/en.search-data.min.c88788fee0bbc6f8d202ce2ad9652258561894883a4c2b22dae8ddae27595333.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome() Autohome the machine.\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.c98160a9b56ff966e31e1ce84e7b583611a3fed8658bbd6c80944f3b650b7ff0.json b/public/en.search-data.min.c98160a9b56ff966e31e1ce84e7b583611a3fed8658bbd6c80944f3b650b7ff0.json
new file mode 100644
index 0000000..5a7bc41
--- /dev/null
+++ b/public/en.search-data.min.c98160a9b56ff966e31e1ce84e7b583611a3fed8658bbd6c80944f3b650b7ff0.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.cb92a71bf272108022864f9f81217f340a3281a7cd6c85c873b240b72e030c34.json b/public/en.search-data.min.cb92a71bf272108022864f9f81217f340a3281a7cd6c85c873b240b72e030c34.json
new file mode 100644
index 0000000..8cd0e40
--- /dev/null
+++ b/public/en.search-data.min.cb92a71bf272108022864f9f81217f340a3281a7cd6c85c873b240b72e030c34.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":4,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":5,"href":"/docs/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":8,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":9,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":12,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":16,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":17,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":18,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":19,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":20,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":21,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":22,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.cd39fbec43262cbf79031d0910fc82273867662ce5240c50a65a93cba1c6850a.json b/public/en.search-data.min.cd39fbec43262cbf79031d0910fc82273867662ce5240c50a65a93cba1c6850a.json
new file mode 100644
index 0000000..d7e172a
--- /dev/null
+++ b/public/en.search-data.min.cd39fbec43262cbf79031d0910fc82273867662ce5240c50a65a93cba1c6850a.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Y.\nmoveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.cdd6382fdba5b5d12d1fa5fb9e8d6c93f835666d942dc95b2d6f8e9a8f9aff06.json b/public/en.search-data.min.cdd6382fdba5b5d12d1fa5fb9e8d6c93f835666d942dc95b2d6f8e9a8f9aff06.json
new file mode 100644
index 0000000..0462c79
--- /dev/null
+++ b/public/en.search-data.min.cdd6382fdba5b5d12d1fa5fb9e8d6c93f835666d942dc95b2d6f8e9a8f9aff06.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":2,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":3,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":4,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":8,"href":"/docs/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":9,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":14,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":18,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":19,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":20,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":23,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":24,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"},{"id":25,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.ce8f33773aa20e2c8eb5535db54d153816affa6e897b7fef2a8a5bc80e8912d8.json b/public/en.search-data.min.ce8f33773aa20e2c8eb5535db54d153816affa6e897b7fef2a8a5bc80e8912d8.json
new file mode 100644
index 0000000..0039c68
--- /dev/null
+++ b/public/en.search-data.min.ce8f33773aa20e2c8eb5535db54d153816affa6e897b7fef2a8a5bc80e8912d8.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":3,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":6,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":9,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":10,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.cffa6a43531f5ca08beb6e22130e6263b113e49c35e26912602aa5188313d167.json b/public/en.search-data.min.cffa6a43531f5ca08beb6e22130e6263b113e49c35e26912602aa5188313d167.json
new file mode 100644
index 0000000..5af7d84
--- /dev/null
+++ b/public/en.search-data.min.cffa6a43531f5ca08beb6e22130e6263b113e49c35e26912602aa5188313d167.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":18,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":19,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.d057f8359fb3efbd65017ecdeb9701734e00b22ccc57302db0f19b0c4da71648.json b/public/en.search-data.min.d057f8359fb3efbd65017ecdeb9701734e00b22ccc57302db0f19b0c4da71648.json
new file mode 100644
index 0000000..af9180d
--- /dev/null
+++ b/public/en.search-data.min.d057f8359fb3efbd65017ecdeb9701734e00b22ccc57302db0f19b0c4da71648.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.d14b1592fca23d09b2af02b33cc42a9d66ff059f80905c483f47d8171942ebbc.json b/public/en.search-data.min.d14b1592fca23d09b2af02b33cc42a9d66ff059f80905c483f47d8171942ebbc.json
new file mode 100644
index 0000000..bdf1f90
--- /dev/null
+++ b/public/en.search-data.min.d14b1592fca23d09b2af02b33cc42a9d66ff059f80905c483f47d8171942ebbc.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":19,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in x, y, and z.\nmoveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.d30b612b163525b92e973de2f067a3eab76e39bc629cbc1fff8798ac022a0978.json b/public/en.search-data.min.d30b612b163525b92e973de2f067a3eab76e39bc629cbc1fff8798ac022a0978.json
new file mode 100644
index 0000000..32ad40b
--- /dev/null
+++ b/public/en.search-data.min.d30b612b163525b92e973de2f067a3eab76e39bc629cbc1fff8798ac022a0978.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\ntravelTo()\nMove to an x,y,z position with a z-hop.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.d4f9e6c23843c83e22e57bb5d046c11d0eff7c3c7421f1d2e863ce7512619ae7.json b/public/en.search-data.min.d4f9e6c23843c83e22e57bb5d046c11d0eff7c3c7421f1d2e863ce7512619ae7.json
new file mode 100644
index 0000000..a4dd73b
--- /dev/null
+++ b/public/en.search-data.min.d4f9e6c23843c83e22e57bb5d046c11d0eff7c3c7421f1d2e863ce7512619ae7.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"hello\nautoHome Autohome the machine (with a `G28` command) and zero the extruder position (with a `G92 E0` command). Syntax # fab.autoHome()\nParameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.d8f743668bdc5397a6f0cca3c13f3931f00a4e92368f7bb01944ab605d59f29a.json b/public/en.search-data.min.d8f743668bdc5397a6f0cca3c13f3931f00a4e92368f7bb01944ab605d59f29a.json
new file mode 100644
index 0000000..79005bc
--- /dev/null
+++ b/public/en.search-data.min.d8f743668bdc5397a6f0cca3c13f3931f00a4e92368f7bb01944ab605d59f29a.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.dbdc6ea5d40b528b04cd5caa2d60eaddbb9451c7daeb9c5e1d3454a0908b430b.json b/public/en.search-data.min.dbdc6ea5d40b528b04cd5caa2d60eaddbb9451c7daeb9c5e1d3454a0908b430b.json
new file mode 100644
index 0000000..7e08b1f
--- /dev/null
+++ b/public/en.search-data.min.dbdc6ea5d40b528b04cd5caa2d60eaddbb9451c7daeb9c5e1d3454a0908b430b.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\nsetNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.de70110fecda8d49639e7b6369078ebc07d9f851d5768274aa605fb033205f8f.json b/public/en.search-data.min.de70110fecda8d49639e7b6369078ebc07d9f851d5768274aa605fb033205f8f.json
new file mode 100644
index 0000000..22179e6
--- /dev/null
+++ b/public/en.search-data.min.de70110fecda8d49639e7b6369078ebc07d9f851d5768274aa605fb033205f8f.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # autoHome()\nAutohome the machine.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\ntravelTo()\nMove to an x,y,z position with a z-hop.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.df4e720b1747d218c92bce0f962086b1a1f6a5166ed72528e5251de6c6ee0969.json b/public/en.search-data.min.df4e720b1747d218c92bce0f962086b1a1f6a5166ed72528e5251de6c6ee0969.json
new file mode 100644
index 0000000..b9ee6ca
--- /dev/null
+++ b/public/en.search-data.min.df4e720b1747d218c92bce0f962086b1a1f6a5166ed72528e5251de6c6ee0969.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":2,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":3,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":4,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":5,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":6,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":7,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":8,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":9,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":10,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":14,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":15,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":16,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":18,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":19,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":20,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":23,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":24,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"},{"id":25,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.e1edc0ad3c25cc2662de94152abc05e9e2cc32eefd678abef7df2468cf727ec7.json b/public/en.search-data.min.e1edc0ad3c25cc2662de94152abc05e9e2cc32eefd678abef7df2468cf727ec7.json
new file mode 100644
index 0000000..4d031e5
--- /dev/null
+++ b/public/en.search-data.min.e1edc0ad3c25cc2662de94152abc05e9e2cc32eefd678abef7df2468cf727ec7.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute()) Set extruder axis to absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.e21491cf6b15f1b52f0253f4a135119405aca3c1d652dc2487600741a7256446.json b/public/en.search-data.min.e21491cf6b15f1b52f0253f4a135119405aca3c1d652dc2487600741a7256446.json
new file mode 100644
index 0000000..aa8925b
--- /dev/null
+++ b/public/en.search-data.min.e21491cf6b15f1b52f0253f4a135119405aca3c1d652dc2487600741a7256446.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # autoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.e34a9d4facccf3d3bb7b409858cb73416d0abd3e5180a5f043f8db24f7064a32.json b/public/en.search-data.min.e34a9d4facccf3d3bb7b409858cb73416d0abd3e5180a5f043f8db24f7064a32.json
new file mode 100644
index 0000000..7b70c23
--- /dev/null
+++ b/public/en.search-data.min.e34a9d4facccf3d3bb7b409858cb73416d0abd3e5180a5f043f8db24f7064a32.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\ntravelTo()\nMove to an x,y,z position with a z-hop.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.e5ba47ebfe13fa9164ce2c9fd1f6bc2e08e4ada79161a09a7a7ac8563631e7eb.json b/public/en.search-data.min.e5ba47ebfe13fa9164ce2c9fd1f6bc2e08e4ada79161a09a7a7ac8563631e7eb.json
new file mode 100644
index 0000000..343448e
--- /dev/null
+++ b/public/en.search-data.min.e5ba47ebfe13fa9164ce2c9fd1f6bc2e08e4ada79161a09a7a7ac8563631e7eb.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.ebd9dd9d03d1a0e52c3fc81573e722db0aeb40d0a464476c6fd31994ee85d4bc.json b/public/en.search-data.min.ebd9dd9d03d1a0e52c3fc81573e722db0aeb40d0a464476c6fd31994ee85d4bc.json
new file mode 100644
index 0000000..5bc536d
--- /dev/null
+++ b/public/en.search-data.min.ebd9dd9d03d1a0e52c3fc81573e722db0aeb40d0a464476c6fd31994ee85d4bc.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.ec643153ef99305dd7d4bb0242b33951252ef9e1c92a59b8ff5f21f7e621b9d7.json b/public/en.search-data.min.ec643153ef99305dd7d4bb0242b33951252ef9e1c92a59b8ff5f21f7e621b9d7.json
new file mode 100644
index 0000000..2ce4974
--- /dev/null
+++ b/public/en.search-data.min.ec643153ef99305dd7d4bb0242b33951252ef9e1c92a59b8ff5f21f7e621b9d7.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. setEAbsolute()\nUse absolute coordinates for extruder position. setEAbsolute()\nUse relative coordinates for extruder position. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.f02035e061c96821618e4891f0bd426e56274a1a58613e08e3183fad12f145de.json b/public/en.search-data.min.f02035e061c96821618e4891f0bd426e56274a1a58613e08e3183fad12f145de.json
new file mode 100644
index 0000000..a62258b
--- /dev/null
+++ b/public/en.search-data.min.f02035e061c96821618e4891f0bd426e56274a1a58613e08e3183fad12f145de.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":22,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.f063290de814ec014ceed7c8c08ab71faa267910f84e401902f200d7320784cc.json b/public/en.search-data.min.f063290de814ec014ceed7c8c08ab71faa267910f84e401902f200d7320784cc.json
new file mode 100644
index 0000000..997d423
--- /dev/null
+++ b/public/en.search-data.min.f063290de814ec014ceed7c8c08ab71faa267910f84e401902f200d7320784cc.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePosition()\nUse absolute coordinates. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.f12f516702011e6c3de6702318c68c98909e08078b9e4fa31f20b89deea0b5c4.json b/public/en.search-data.min.f12f516702011e6c3de6702318c68c98909e08078b9e4fa31f20b89deea0b5c4.json
new file mode 100644
index 0000000..eb4ce03
--- /dev/null
+++ b/public/en.search-data.min.f12f516702011e6c3de6702318c68c98909e08078b9e4fa31f20b89deea0b5c4.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position with a z-hop.\nmoveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.f76214aeb45811c3dbe8028a1b8eee01fc2658169071c7c5396da9c179eacce6.json b/public/en.search-data.min.f76214aeb45811c3dbe8028a1b8eee01fc2658169071c7c5396da9c179eacce6.json
new file mode 100644
index 0000000..999fee2
--- /dev/null
+++ b/public/en.search-data.min.f76214aeb45811c3dbe8028a1b8eee01fc2658169071c7c5396da9c179eacce6.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. setAbsolutePosition()\nUse absolute coordinates. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. setEAbsolute()\nUse absolute coordinates for extruder position. setEAbsolute()\nUse relative coordinates for extruder position. setAbsolutePositionXYZ()\nUse absolute coordinates for dimensional axes. "},{"id":4,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":5,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":7,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":8,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":11,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":12,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":13,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":14,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":15,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":22,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":23,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that G90 behaviour differs depending on firmware. For example, Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions independently, see setAbsolutePositionXYZ(), setRelativePositionXYZ(), setEAbsolute(), \u0026amp; setERelative().\nSyntax # fab.setAbsolutePosition() Parameters # None\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position XYZ","section":"Reference","content":"setAbsolutePositionXYZ() Set X/Y/Z axes to absolute position, relative to the origin of the machine, without changing the extruder positioning mode. Syntax # fab.setAbsolutePositionXYZ() Parameters # None\n"},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/seteabsolute/","title":"Set E Absolute","section":"Reference","content":"setEAbsolute() Set extruder axis to use absolute position, relative to the origin, without changing the dimensional axes positioning mode. Syntax # fab.setEAbsolute() Parameters # None\n"},{"id":27,"href":"/docs/reference/reference-pages/seterelative/","title":"Set E Relative","section":"Reference","content":"setERelative() Set extruder axis to use relative position without changing the dimensional axes positioning mode. Syntax # fab.setERelative() Parameters # None\n"},{"id":28,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":29,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":30,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.f79486bd15a55d330b1fa3f4ef0a360fa5c542d31a568fec5b62db13d327a41a.json b/public/en.search-data.min.f79486bd15a55d330b1fa3f4ef0a360fa5c542d31a568fec5b62db13d327a41a.json
new file mode 100644
index 0000000..4749191
--- /dev/null
+++ b/public/en.search-data.min.f79486bd15a55d330b1fa3f4ef0a360fa5c542d31a568fec5b62db13d327a41a.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" setBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":13,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":20,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":21,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.f9db45a23cb4497e8bc2c2f600250beb94d650a0523c2e7b87477e512bf4dfa3.json b/public/en.search-data.min.f9db45a23cb4497e8bc2c2f600250beb94d650a0523c2e7b87477e512bf4dfa3.json
new file mode 100644
index 0000000..953f01f
--- /dev/null
+++ b/public/en.search-data.min.f9db45a23cb4497e8bc2c2f600250beb94d650a0523c2e7b87477e512bf4dfa3.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":12,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetBedT # Set the printer\u0026rsquo;s bed temperature. By default, this command will wait for the bed temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\nmoveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.fa11f048f1b592c754cab90f1404f8f79d243ac5b152e6a7c6e996a672b104ea.json b/public/en.search-data.min.fa11f048f1b592c754cab90f1404f8f79d243ac5b152e6a7c6e996a672b104ea.json
new file mode 100644
index 0000000..aa40fbd
--- /dev/null
+++ b/public/en.search-data.min.fa11f048f1b592c754cab90f1404f8f79d243ac5b152e6a7c6e996a672b104ea.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":2,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":3,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # moveTo()\nMove to a point. moveToX()\nMove to an X position. moveToY()\nMove to a Y position. moveToZ()\nMove to a Z position. moveToE()\nMove to a E position. move()\nMove relative to current position in x, y, and z. moveX()\nMove relative to current position in X. moveY()\nMove relative to current position in Y. moveZ()\nMove relative to current position in Z. moveE()\nMove relative to current position in E. moveExtrude()\nMove to an x,y,z position while extruding. travelTo()\nMove to an x,y,z position with a z-hop. G \u0026amp; M Codes # autoHome()\nAutohome the machine. setBedT()\nSet bed temperature. setNozzleT()\nSet nozzle temperature. setTemps()\nSet nozzle \u0026 bed temperatures. "},{"id":4,"href":"/docs/reference/reference-pages/setabsolutepositionxyz/","title":"Set Absolute Position Xyz","section":"Reference","content":"to come\n"},{"id":5,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":6,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":7,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":"autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None\n"},{"id":8,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":9,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":10,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":11,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":"move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":12,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":"moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) extrusion Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of `[multiplication]` parameter multiplication Boolean, optional. If true, `extrusion` value is used as a multiplication modifier to default extrusion calculation. If fase, `extrusion` value is used a total amount of filament to deposit in mm. False by default. "},{"id":13,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":"moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":"moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)"},{"id":15,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":"moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":"moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":"moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":"moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":19,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":"moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":"moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":"moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "},{"id":22,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":23,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":24,"href":"/docs/reference/reference-pages/setabsoluteposition/","title":"Set Absolute Position","section":"Reference","content":"setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that behaviour differs depending on firmware. For example, G90 on Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions seperately, see setAbsolutePositionXYZ().\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/setbedt/","title":"Set Bed Temp","section":"Reference","content":"setBedT() Set the printer's bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":26,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":"setNozzleT() Set the printer's nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":27,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":"setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":28,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":"travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.fdf83f427e5e85cf54a6b147dbcf542a22b238521d962dcbec69aae302f03f06.json b/public/en.search-data.min.fdf83f427e5e85cf54a6b147dbcf542a22b238521d962dcbec69aae302f03f06.json
new file mode 100644
index 0000000..5bef51c
--- /dev/null
+++ b/public/en.search-data.min.fdf83f427e5e85cf54a6b147dbcf542a22b238521d962dcbec69aae302f03f06.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":3,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":4,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":5,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":6,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":7,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":8,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":9,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # autoHome()\nAutohome the machine. autoHome()\nAutohome the machine. Paragraph Text Fab # autoHome()\nAutohome the machine.\nsetNozzleT()\nSet nozzle temperature.\nsetBedT()\nSet bed temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nmoveExtrude()\nMove to an x,y,z position while extruding.\n"}]
\ No newline at end of file
diff --git a/public/en.search-data.min.fe0941d300a2370fc90ac6edc4c194ea7c53bf16dc26d1a4463f8e32d18a9818.json b/public/en.search-data.min.fe0941d300a2370fc90ac6edc4c194ea7c53bf16dc26d1a4463f8e32d18a9818.json
new file mode 100644
index 0000000..493903c
--- /dev/null
+++ b/public/en.search-data.min.fe0941d300a2370fc90ac6edc4c194ea7c53bf16dc26d1a4463f8e32d18a9818.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":2,"href":"/docs/reference/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":3,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":4,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":5,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":7,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":8,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"},{"id":11,"href":"/docs/reference/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":12,"href":"/docs/reference/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":13,"href":"/docs/reference/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":14,"href":"/docs/reference/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":15,"href":"/docs/reference/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference/reference-pages/movetoe/","title":"Move To E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference/reference-pages/movetox/","title":"Move To X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference/reference-pages/movex/","title":"Move To X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":19,"href":"/docs/reference/reference-pages/movetoy/","title":"Move To Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":20,"href":"/docs/reference/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference/reference-pages/movee/","title":"moveE","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference/reference-pages/movetoz/","title":"MoveToZ","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":23,"href":"/docs/reference/reference-pages/movez/","title":"MoveZ","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":24,"href":"/docs/reference/reference-pages/setnozzlet/","title":"Set Nozzle Temp","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":25,"href":"/docs/reference/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "}]
\ No newline at end of file
diff --git a/public/en.search-data.min.fefbbafff9709c04c0513eb160c0dcf2613bb13447e9dc11b095c6e4f9b9674c.json b/public/en.search-data.min.fefbbafff9709c04c0513eb160c0dcf2613bb13447e9dc11b095c6e4f9b9674c.json
new file mode 100644
index 0000000..a27e0f7
--- /dev/null
+++ b/public/en.search-data.min.fefbbafff9709c04c0513eb160c0dcf2613bb13447e9dc11b095c6e4f9b9674c.json
@@ -0,0 +1 @@
+[{"id":0,"href":"/docs/resources/guides/dfab-intro/","title":"A Gentle Introduction to Digital Fabrication","section":"Resources","content":" A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nThe ABCs of CAD, CAM, \u0026amp; CNC # Digital fabrication is the process of using computer-controlled machines to create physical objects. This process might be additive (e.g. 3D printing), subtractive (e.g. milling, laser cutting), or something else entirely (e.g. using a liquid handling robot for science experiments). Typically, we would follow the following steps to make an object:\nDesign a model. Using computer-aided design (CAD) software, we first need to design the object we want to make. There are lots of different CAD softwares; popular options include Rhino, Fusion360, FreeCAD, and TinkerCAD. There are also websites where makers can share premade models, like Thingiverse for 3D printing. Choose fabrication settings. Computer-aided manufacturing (CAM) software is used to plan the machines toolpaths\u0026ndash;or the path the machine will take as it moves through space\u0026ndash;based on the model. For 3D printing, this is called the \u0026lsquo;slicer\u0026rsquo; since the model is divided into a series of flat, 2D contours which are stacked vertically. In the CAM software, we can choose a bunch of different settings depending on the machine we\u0026rsquo;re using. For a 3D printer we can set how fast the machine should move and at what temperature should be set to melt the plastic; for a laser cutter, we can set the power of the laser. Run the machine. The CAM software will generate instructions for the computer-numeric control (CNC) machine. This process is incredibly powerful for a lot of use cases! There are a some drawbacks, though, which motivate the design of p5.fab. It\u0026rsquo;s hard to experiment creatively with different settings, since existing software assumes you want to precicely replicate the same thing many times. If you want to change a model, you need to return back to your CAD software and start again. And it requires owning and learning CAD software. p5.fab tries to offer an alternate entry point into digital fabrication by way of creative coding, integrating toolpath design and machine execution into a single environment.\nG-Code # G-Code (or ‘geometry code’) is the standard language used by CNC machines1. We can use G-Code to move the machine around! By default, the machine will use millimeter for its units. To move to the (x, y, z) position (100mm, 50mm, 200mm) using G-Code, we can use the command:\nG1 X100 Y50 Z200 ; move the the position (100, 50, 200)\nwhere G1 is the command for a ‘linear move’. Everything after the semicolon is a comment and is ignored by the machine. We could also set a speed to move at using an F parameter:\nG1 X100 Y50 Z200 F6000 ; move the the position (100, 50, 200) ; at a speed of 6000 mm/min` The F parameter sets the feedrate, or speed, to move. Of course, these settings are subject to the physical realities. If your machine is only 300mm tall, then sending a G1 Z500 will only move to a height of 300. Similarly, the machine might not be able to move as fast as you tell it to. G-Code is used in tandem with M-Codes (or ‘miscellaneous codes’) which control non-movement related functions. For example, the command M203 will set the maximum speed which each axis can move.\nDifferent machines might use slightly different sets (or \u0026lsquo;flavors\u0026rsquo;) of GCode. This depends on the control board which the machine uses (which turns G-Code commands into machine movements) and the firmware which the control board uses. p5.fab works with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use on their machines, as well as various custom/open-source machines. For a complete list of G and M Codes supported on Marline, check out the G-Code Dictionary.\nAlready, you might see how tedious it would be to plan movements using GCode directly. p5.fab lets you use Javascript code to build up many commands.\nCoordinate Systems # To send the machine to a position to move to, the machine has to know where it is. This is accomplished by ‘homing’ the machine when you first power it on. Most machines have 3 dimensional axes (X, Y, \u0026amp; Z). Other machines might have more; a 3D printer also has an extruder, or E axis which tracks how much filament is being extruded.\nOur G-Code movement commands can be interpreted as absolute or relative moves by the machine. In absolute positioning mode, the machine will move relative to the origin. In relative positioning mode, the machine will move relative to its last position. We can change our positioning mode using G-Codes: G90 to use absolute positions and G91 for relative. For example, say we start at the origin (0,0,0). Consider the following move commands:\n; to start, we are at the origin (0,0,0) G90 ; use absolute positioning G1 X100 Y50 Z200 ; move to the absolute position (100, 50, 200) G91 ; use relative positioning G1 X100 ; move 100mm in X relative to the last position In this example, the machine will end up at the position (200, 50, 200). Note that all subsequent commands will be in relative mode unless we explicitly return to absolute mode with a G90 command.\nThere are others, too! These are often machine-specific. For example, the popular AxiDraw pen plotter uses the EBB command set, or the ShopBot CNC machines uses SBP codes.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":1,"href":"/docs/reference-pages/autohome/","title":"Autohome","section":"Reference","content":" autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).\nSyntax # fab.autoHome()\nParameters # None\n"},{"id":2,"href":"/docs/quickstart/","title":"Quickstart","section":"Docs","content":" p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.\nOnline Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click \u0026lsquo;Connect\u0026rsquo;. Start making! Press \u0026lsquo;Print\u0026rsquo; to start streaming commands to your machine. Be sure to keep an eye out for anything that goes wrong; there\u0026rsquo;s no guarantee that your code will \u0026lsquo;work\u0026rsquo; in any conventional sense, but that\u0026rsquo;s part of the fun! Alternative Option: Local Installation # If you\u0026rsquo;d like to use your preferred code editor while using p5.fab:\nDownload the p5.fab.js library file and add the path to the \u0026lt;head\u0026gt; tag of your index.html file:\n\u0026lt;script src=\u0026quot;p5.fab.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt;\nYou should also add it\u0026rsquo;s dependencies, the p5.js library and the webserial communication:\n\u0026lt;script src=\u0026quot;https://cdn.jsdelivr.net/npm/p5@1.9.2/lib/p5.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; \u0026lt;script src=\u0026quot;https://unpkg.com/p5-webserial@0.1.1/build/p5.webserial.js\u0026quot;\u0026gt;\u0026lt;/script\u0026gt; Run a local server; this is required for communicating between the machine and your computer. See this guide for details on how to do this!\nOpen your sketch in Chrome1 and start making!\nWe use serial communication to communicate with the machine; Chrome is the only browser which supports WebSerial, which let\u0026rsquo;s us get up and running even quicker!\u0026#160;\u0026#x21a9;\u0026#xfe0e;\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nCheck out the Machine Compatability Page for more information on what machines are currently supported.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":3,"href":"/docs/resources/guides/cc-intro/","title":"A Gentle Introduction to Creative Coding with p5.js","section":"Resources","content":" A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.fab, jump ahead to the primer.\nWhat is Creative Code? # Creative code is broadly the practice of programming for expressive rather than functional purposes. There are many different creative coding libraries/frameworks/toolkits; some popular ones are p5.js, Processing, and OpenFrameworks. Different tools are surrounded by vibrant communities artists, designers, engineers, tinkerers, and anyone else who is interested in coding for the visual arts. p5.fab is built specifically to work with p5.js.\nAnatomy of a Sketch # In progress.\nGoing Further # In progress.\n"},{"id":4,"href":"/docs/machine-compatibility/","title":"Machine Compatibility","section":"Docs","content":" Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We\u0026rsquo;ve tested p5.fab on the following machines:\nMachine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill). Stay tuned!\n"},{"id":5,"href":"/docs/resources/guides/p5fab-primer/","title":"p5.fab Primer","section":"Resources","content":" p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.\nAnatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go! A typical sketch will look something like this:\nlet fab; function setup() { createCanvas(windowWidth, windowHeight, WEBGL); // we need to use WEBGL mode to draw 3D things fab = createFab(); // fab represents our machine } function fabDraw() { // fabDraw will be run immediately after the setup function! // Machine control commands will go here } function draw() { background(255); // a solid white background fab.render(); } In this example sketch, we declare a fab variable and use createFab to instantiate a fab object. By default, this will use default values for a Creality Ender3 3D printer. In createCanvas, we use WEBGL mode to support 3D shapes; then in draw(), we use the built-in fab.render() to show a simple visualization of our toolpaths. Since our fabDraw() loop is empty, this sketch would show and empty work envelope for now.\nMoving, Grooving, and Extruding # Let\u0026rsquo;s send some toolpath commands for 3D printing! Most of the time, we\u0026rsquo;ll want to send a few starting commands:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); // set all axes (x/y/z/extruder) to absolute fab.setERelative(); // put extruder in relative mode, independent of other axes fab.autoHome(); fab.setTemps(205, 60); // (nozzle, bed) °C - you should use a temperature best suited for your material } The first two commands will explicitly set the machine into absolute positioning mode, and use relative mode for the extrusion axis. This is worth doing in case your machine ended in a different mode in whatever you were last doing. Then, we\u0026rsquo;ll home the machine and wait for the nozzle and bed to heat up to the specified temperatures.\nNow we\u0026rsquo;re ready to send some movement commands! Let\u0026rsquo;s move to the point (100, 100, 0.2) on the bed; we choose 0.2 for the height because this is approximately a good starting height to lay filament down on the bed1:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! fab.move(100, 100, 0.2); // (x, y, z) } If you were to send this code to your machine, you should see the printer (1) autohome, (2) get up to temperature, and then (c) move to the (x, y, z) point (100, 100, 1). All movement commands will use a default speed of 20 mm/sec. If we want to move to the center of the bed, we can also access the machine\u0026rsquo;s maxX and maxY properties:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.move(center.x, center.y, 0.2); // (x, y, z) } where createVector is a handy p5.js function.While moving, we might find that a bit of filament oozes out of the nozzle. This is because filament might melt and fall out of the hot nozzle. To prevent this, we can instead use a moveRetract() command which will pull the filament away from the nozzle. We can also try moving a bit faster:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 0.2, 30); // (x, y, z, speed in mm/s) } moveRetract will pull the filament away from the nozzle before moving, and then restore the position (or \u0026lsquo;prime\u0026rsquo;) once it arrives at its destination. By contrast, moveExtrude will lay down filament along the specified path. By default, it will calculate the amount of filament needed based on the distance and the nozzle \u0026amp; filament diameter:\nfunction fabDraw() { // Set the machine up for printing fab.setAbsolutePosition(); fab.setERelative(); fab.autoHome(); fab.setTemps(205, 60); // Now move around! let center = createVector(fab.maxX/2, fab.maxY/2) fab.moveRetract(center.x, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.moveExtrude(center.x + 100, center.y, 1, 30); // (x, y, z, speed in mm/s) fab.presentPart(); } Now, we should have a 100mm line of filament printed on the bed! The presentPart() command will push the bed plate out and the hotend up so that it\u0026rsquo;s easy to grab the printed part when complete.\nNext Steps # We\u0026rsquo;re ready to 3D print an object now! Jump to the printing a cube tutorial for some more details on 3D printing with p5.fab.\nIn practice, you\u0026rsquo;ll have to find a start height that works well for you based on your bed leveling, filament \u0026amp; nozzle diameter, etc. Typically, a height of 0 is too close to the bed (filament can\u0026rsquo;t get out of the nozzle), and too large a value means the filament won\u0026rsquo;t stick to the bed.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n"},{"id":6,"href":"/docs/resources/tutorials/cube-tutorial/","title":"Cube Tutorial","section":"Resources","content":" Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.\n"},{"id":7,"href":"/docs/resources/tutorials/non-planar-tutorial/","title":"Non-Planar Printing Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.\n"},{"id":8,"href":"/docs/resources/","title":"Resources","section":"Docs","content":" Resources # Here you\u0026rsquo;ll find some resources for using p5.fab, including guides which introduce key concepts, tutorials which put these concepts into practice, and examples to motivate more uses!\nThe resources here are growing; if there\u0026rsquo;s something you\u0026rsquo;d like to see added or contribute, reach out on github!\nGuides # A Gentle Introduction to Digital Fabrication # A (very!) brief overview of some key digital fabrication concepts, including: G-Code, coordinate systems, machines, and their firmware. Intended for anyone new to using machines like 3D printers.\nA Gentle Introduction to Creative Coding with p5.js # A (very!) brief overview of some key creative coding concepts, including: how to sketch with p5.js. Intended for anyone new to creative coding.\np5.fab Primer # An overview of the p5.fab library!\nTutorials # Printing a cube # A first 3D printed object with p5.fab!\nNon-Planar 3D Printing # Putting the \u0026lsquo;3D\u0026rsquo; in 3D printing.\nLine Vase 3D Print # Tuning printing parameters to create delicate structures.\nExamples # more examples to come!\n"},{"id":9,"href":"/docs/resources/tutorials/line-vase-tutorial/","title":"Line Vase Tutorial","section":"Resources","content":" Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.\n"},{"id":10,"href":"/docs/reference-pages/fab/","title":"Fab","section":"Reference","content":" Fab # A class to describe a fabrication machine.\nA fab object represents a 3D printer. It is comprised of the following information:\nworkEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])\nParameters # config: a json object specifying requisite machine information "},{"id":11,"href":"/docs/reference-pages/move/","title":"Move","section":"Reference","content":" move # Move relative to the current position without extruding material.\nSyntax # fab.move(dx, dy, dz, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default) dy: Number, the relative y distance to move (in current units, mm by default) dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":12,"href":"/docs/reference-pages/movee/","title":"Move E","section":"Reference","content":" moveE # Move in E relative to the current position.\nSyntax # fab.moveE(de, [velocity])\nParameters # de: Number, the relative e distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":13,"href":"/docs/reference-pages/moveextrude/","title":"Move Extrude","section":"Reference","content":" moveExtrude # Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified.\nSyntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) extrusion: Number, optional. Interpreted as either (a) the total amount of filament to be deposited over the move, or (b) a multiplication value to modify default caluclations, depending on value of [multiplication] parameter multiplication: Boolean, optional. If true, extrusion value is used as a multiplication modifier to default extrusion calculation. If fase, extrusion value is used a total amount of filament to deposit in mm. False by default. "},{"id":14,"href":"/docs/reference-pages/moveto/","title":"Move To","section":"Reference","content":" moveTo # Move directly to an absolute (x,y,z) position without extruding material.\nSyntax # fab.moveTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":15,"href":"/docs/reference-pages/movetoe/","title":"Move to E","section":"Reference","content":" moveToE # Move directly to an absolute E position.\nSyntax # fab.moveToE(e, [velocity])\nParameters # e: Number, the e position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":16,"href":"/docs/reference-pages/movetox/","title":"Move to X","section":"Reference","content":" moveToX # Move directly to an absolute X position without extruding material.\nSyntax # fab.moveToX(x, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":17,"href":"/docs/reference-pages/movetoy/","title":"Move to Y","section":"Reference","content":" moveToY # Move directly to an absolute Y position without extruding material.\nSyntax # fab.moveToY(y, [velocity])\nParameters # y: Number, the y position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":18,"href":"/docs/reference-pages/movetoz/","title":"Move to Z","section":"Reference","content":" moveToZ # Move directly to an absolute Z position without extruding material.\nSyntax # fab.moveToZ(z, [velocity])\nParameters # z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":19,"href":"/docs/reference-pages/movex/","title":"Move X","section":"Reference","content":" moveX # Move in X relative to the current position without extruding material.\nSyntax # fab.moveX(dx, [velocity])\nParameters # dx: Number, the relative x distance to move (in current units, mm by default)\nv: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)\ndx: Number, the relative x distance to move (in current units, mm by default)\n"},{"id":20,"href":"/docs/reference-pages/movey/","title":"Move Y","section":"Reference","content":" moveY # Move in Y relative to the current position without extruding material.\nSyntax # fab.moveY(dy, [velocity])\nParameters # dy: Number, the relative y distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":21,"href":"/docs/reference-pages/movez/","title":"Move Z","section":"Reference","content":" moveZ # Move in Z relative to the current position without extruding material.\nSyntax # fab.moveZ(dz, [velocity])\nParameters # dz: Number, the relative z distance to move (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":22,"href":"/docs/reference-pages/setnozzlet/","title":"Set Nozzle T","section":"Reference","content":" setNozzleT # Set the printer\u0026rsquo;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setNozzleT(temperature, [wait])\nParameters # temperature: Number, the temperature to heat the nozzle to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":23,"href":"/docs/reference-pages/settemps/","title":"Set Temps","section":"Reference","content":" setTemps # Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously.\nMost firmware won\u0026rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.\nSyntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait])\nParameters # nozzleTemperature: Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature: Number, the temperature to heat the bed to in degrees Celcius wait: Boolean, optional parameter to wait for the target temperature to be reached before proceeding. True by default. "},{"id":24,"href":"/docs/reference-pages/travelto/","title":"Travel To","section":"Reference","content":" travelTo # Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material.\nThe hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.\nSyntax # fab.travelTo(x, y, z, [velocity])\nParameters # x: Number, the x position to move to (in current units, mm by default) y: Number, the y position to move to (in current units, mm by default) z: Number, the z position to move to (in current units, mm by default) v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default) "},{"id":25,"href":"/docs/reference/","title":"Reference","section":"Docs","content":" Reference # Fab # Path Commands # Commands related to movements.\nmoveTo()\nMove to a point.\nmoveToX()\nMove to an X position.\nmoveToY()\nMove to a Y position.\nmoveToZ()\nMove to a Z position.\nmoveToE()\nMove to a E position.\nmove()\nMove relative to current position in x, y, and z.\nmoveX()\nMove relative to current position in X.\nmoveY()\nMove relative to current position in Y.\nmoveZ()\nMove relative to current position in Z.\nmoveE()\nMove relative to current position in E.\nmoveExtrude()\nMove to an x,y,z position while extruding.\ntravelTo()\nMove to an x,y,z position with a z-hop.\nG \u0026amp; M Codes # Other G and M Codes, not related to movement.\nautoHome()\nAutohome the machine.\nsetBedT()\nSet bed temperature.\nsetNozzleT()\nSet nozzle temperature.\nsetTemps()\nSet nozzle \u0026amp; bed temperatures.\n"}]
\ No newline at end of file
diff --git a/public/en.search.min.0629cc2dcd1514be91a03b7c4d2fffdb5543bf29094bb2063c392f0ae60a14e4.js b/public/en.search.min.0629cc2dcd1514be91a03b7c4d2fffdb5543bf29094bb2063c392f0ae60a14e4.js
new file mode 100644
index 0000000..05aef0b
--- /dev/null
+++ b/public/en.search.min.0629cc2dcd1514be91a03b7c4d2fffdb5543bf29094bb2063c392f0ae60a14e4.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.558a1fe6ec355ea263b1c72da9b076f4f30b599a70f896650925a0ff96716a34.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.0aca526e065b9eb8ea0de32118f4bfdd95a1cdcb5192c60385bba27b4c4eda08.js b/public/en.search.min.0aca526e065b9eb8ea0de32118f4bfdd95a1cdcb5192c60385bba27b4c4eda08.js
new file mode 100644
index 0000000..086c0c9
--- /dev/null
+++ b/public/en.search.min.0aca526e065b9eb8ea0de32118f4bfdd95a1cdcb5192c60385bba27b4c4eda08.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c98160a9b56ff966e31e1ce84e7b583611a3fed8658bbd6c80944f3b650b7ff0.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.104744330f9e84d2e0c6180293dd1d823cdeeb343dee9cea738e069dfb565420.js b/public/en.search.min.104744330f9e84d2e0c6180293dd1d823cdeeb343dee9cea738e069dfb565420.js
new file mode 100644
index 0000000..8df46cb
--- /dev/null
+++ b/public/en.search.min.104744330f9e84d2e0c6180293dd1d823cdeeb343dee9cea738e069dfb565420.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.45287d4bab40c91556d0ee400339d653f8b533533fac5465d32398e76b03b8b3.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.10567831423c19baa1a8e4ee806278124e30d4897a96aaf7fff17f8e4852983c.js b/public/en.search.min.10567831423c19baa1a8e4ee806278124e30d4897a96aaf7fff17f8e4852983c.js
new file mode 100644
index 0000000..f290f90
--- /dev/null
+++ b/public/en.search.min.10567831423c19baa1a8e4ee806278124e30d4897a96aaf7fff17f8e4852983c.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bba190c71a3a3ce31d639c79c1fa94ff070e7d5643793d3b6875fb107ff215e3.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.1062e4728e1a75483bd4f9e11807cd2a5141fe0c0f945e9024402d1664f48d2f.js b/public/en.search.min.1062e4728e1a75483bd4f9e11807cd2a5141fe0c0f945e9024402d1664f48d2f.js
new file mode 100644
index 0000000..57b614d
--- /dev/null
+++ b/public/en.search.min.1062e4728e1a75483bd4f9e11807cd2a5141fe0c0f945e9024402d1664f48d2f.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.f9db45a23cb4497e8bc2c2f600250beb94d650a0523c2e7b87477e512bf4dfa3.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.1cc3252b5b149dbe2cda0ef14b7ff7609b47c457f094d2c89b291011b56bcc9a.js b/public/en.search.min.1cc3252b5b149dbe2cda0ef14b7ff7609b47c457f094d2c89b291011b56bcc9a.js
new file mode 100644
index 0000000..9d84042
--- /dev/null
+++ b/public/en.search.min.1cc3252b5b149dbe2cda0ef14b7ff7609b47c457f094d2c89b291011b56bcc9a.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.fdf83f427e5e85cf54a6b147dbcf542a22b238521d962dcbec69aae302f03f06.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.1e1860c723036faf16afd0faf0b5f4f039969fd0b90323b2ebddf57225724333.js b/public/en.search.min.1e1860c723036faf16afd0faf0b5f4f039969fd0b90323b2ebddf57225724333.js
new file mode 100644
index 0000000..599f7ea
--- /dev/null
+++ b/public/en.search.min.1e1860c723036faf16afd0faf0b5f4f039969fd0b90323b2ebddf57225724333.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.d8f743668bdc5397a6f0cca3c13f3931f00a4e92368f7bb01944ab605d59f29a.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.1e8c11fb3f421d9bb0be55a206a64c24b669773267605536157269c618f7453b.js b/public/en.search.min.1e8c11fb3f421d9bb0be55a206a64c24b669773267605536157269c618f7453b.js
new file mode 100644
index 0000000..b9b4ff6
--- /dev/null
+++ b/public/en.search.min.1e8c11fb3f421d9bb0be55a206a64c24b669773267605536157269c618f7453b.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.509c32f44d58feb440f3a80dbffc45f22f075676b5aa4026d1babde6cd5b9615.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.21dbb425d5122f534606d6480caff7ec2e5a14017891ef9bd5bc181e9066c225.js b/public/en.search.min.21dbb425d5122f534606d6480caff7ec2e5a14017891ef9bd5bc181e9066c225.js
new file mode 100644
index 0000000..b4f154f
--- /dev/null
+++ b/public/en.search.min.21dbb425d5122f534606d6480caff7ec2e5a14017891ef9bd5bc181e9066c225.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.07da1c07887873ff0ed10034829f7fe104d2733eaeaf7b7d05a2333e7025a671.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.2371012a26f7d7de5940d6856beead7a057040968768aebe96199b2bbad09452.js b/public/en.search.min.2371012a26f7d7de5940d6856beead7a057040968768aebe96199b2bbad09452.js
new file mode 100644
index 0000000..f230696
--- /dev/null
+++ b/public/en.search.min.2371012a26f7d7de5940d6856beead7a057040968768aebe96199b2bbad09452.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.4cd73e6faf0a4832708bee25e9cee2e922f6b9acc960cead3e744a3d329e8035.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.2429b6cf960d4bd768a8e3de75bd15a3cd2c52ff5c8926e72522560dc018e655.js b/public/en.search.min.2429b6cf960d4bd768a8e3de75bd15a3cd2c52ff5c8926e72522560dc018e655.js
new file mode 100644
index 0000000..6943e2b
--- /dev/null
+++ b/public/en.search.min.2429b6cf960d4bd768a8e3de75bd15a3cd2c52ff5c8926e72522560dc018e655.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.60207e4f0aa5d2fad2003bbaabed610c01aabdf07db05aea4431ae292667aaad.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.245096908ebf862a16d9bd22cba628242011cd4f0bb566e5a815cf05422825a7.js b/public/en.search.min.245096908ebf862a16d9bd22cba628242011cd4f0bb566e5a815cf05422825a7.js
new file mode 100644
index 0000000..1453fd4
--- /dev/null
+++ b/public/en.search.min.245096908ebf862a16d9bd22cba628242011cd4f0bb566e5a815cf05422825a7.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.5fa0a25113e01e3f1618a9614f0ef7fb9d331a4f03d4af45671d21e60b53678c.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.24524669a41d2dfde47a5abe42ebdd94480d0f428cc116e95050f66353746858.js b/public/en.search.min.24524669a41d2dfde47a5abe42ebdd94480d0f428cc116e95050f66353746858.js
new file mode 100644
index 0000000..4a3b1e2
--- /dev/null
+++ b/public/en.search.min.24524669a41d2dfde47a5abe42ebdd94480d0f428cc116e95050f66353746858.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.79ff799fcc7040c6b45c0e3ec2374f07bec15ba12622a7a3c0ca79b37b4e00fa.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.24ef9fafae4cf9e4f1ceca358b3072f0892f80671d367823439c4966b256043b.js b/public/en.search.min.24ef9fafae4cf9e4f1ceca358b3072f0892f80671d367823439c4966b256043b.js
new file mode 100644
index 0000000..87957e7
--- /dev/null
+++ b/public/en.search.min.24ef9fafae4cf9e4f1ceca358b3072f0892f80671d367823439c4966b256043b.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.861af178428f7141bab3f1ad83c730053f4c81847dcb660ad19e42c63c9a444c.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.25eff2342e67788647ad9e58f55abba0661bc31801cdf0a3bcd7c9a0b4597d8d.js b/public/en.search.min.25eff2342e67788647ad9e58f55abba0661bc31801cdf0a3bcd7c9a0b4597d8d.js
new file mode 100644
index 0000000..0fc20ea
--- /dev/null
+++ b/public/en.search.min.25eff2342e67788647ad9e58f55abba0661bc31801cdf0a3bcd7c9a0b4597d8d.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6a61eb24f5e6c6205b4947d8d855387a9c63d0dae18887b9b660fdd40fe6bf90.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.25f8523e3174437056d210138542ea69842ea176dd4cd781e8a285fb3d02a395.js b/public/en.search.min.25f8523e3174437056d210138542ea69842ea176dd4cd781e8a285fb3d02a395.js
new file mode 100644
index 0000000..ee9b831
--- /dev/null
+++ b/public/en.search.min.25f8523e3174437056d210138542ea69842ea176dd4cd781e8a285fb3d02a395.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.d30b612b163525b92e973de2f067a3eab76e39bc629cbc1fff8798ac022a0978.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.26878aa7b55750513c9fcaa7bdaccc59c0259a399214a9a09cee7d46b538b6f7.js b/public/en.search.min.26878aa7b55750513c9fcaa7bdaccc59c0259a399214a9a09cee7d46b538b6f7.js
new file mode 100644
index 0000000..422223b
--- /dev/null
+++ b/public/en.search.min.26878aa7b55750513c9fcaa7bdaccc59c0259a399214a9a09cee7d46b538b6f7.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.d057f8359fb3efbd65017ecdeb9701734e00b22ccc57302db0f19b0c4da71648.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.29a385c6d15d1a4bebdc4a722519a155c5e313bff9e09b81653e2578d86ed2f7.js b/public/en.search.min.29a385c6d15d1a4bebdc4a722519a155c5e313bff9e09b81653e2578d86ed2f7.js
new file mode 100644
index 0000000..cb5992a
--- /dev/null
+++ b/public/en.search.min.29a385c6d15d1a4bebdc4a722519a155c5e313bff9e09b81653e2578d86ed2f7.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.7375df6b62db53129f7a7d4733d0976a055f0ed41df653a39a82859938ffde6f.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.29ee4a27c88fbddb01bb83c8ea71080a604c3a98346e6dfc66569ee1c4f32c39.js b/public/en.search.min.29ee4a27c88fbddb01bb83c8ea71080a604c3a98346e6dfc66569ee1c4f32c39.js
new file mode 100644
index 0000000..283e89d
--- /dev/null
+++ b/public/en.search.min.29ee4a27c88fbddb01bb83c8ea71080a604c3a98346e6dfc66569ee1c4f32c39.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.860e6fe1a873ebe98edd5b07f77b615f4f8d5b8281b6fc1c2a3c7cb4044fbf8a.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.2cf3e378c7fd5dbe2e2e6224e818730dbff89454657291bbd4859d0cef48a675.js b/public/en.search.min.2cf3e378c7fd5dbe2e2e6224e818730dbff89454657291bbd4859d0cef48a675.js
new file mode 100644
index 0000000..f6685df
--- /dev/null
+++ b/public/en.search.min.2cf3e378c7fd5dbe2e2e6224e818730dbff89454657291bbd4859d0cef48a675.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6577178d88c8978f5ae22e93c7dcb991bb5ac3970dfe6ecc444bdb7ac39e22d0.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.2fa4a401beb2d9954e2cabb23c808621efe5340455500c9ebfc626dfc04db1a2.js b/public/en.search.min.2fa4a401beb2d9954e2cabb23c808621efe5340455500c9ebfc626dfc04db1a2.js
new file mode 100644
index 0000000..8c91c97
--- /dev/null
+++ b/public/en.search.min.2fa4a401beb2d9954e2cabb23c808621efe5340455500c9ebfc626dfc04db1a2.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.165780119ee4cfe69ff1bd1b15899881ec0273271360f28f28435bd07f28fdfb.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.2fd0f573bd555cdf637740e915465ab9f06016cbf9762057bde7edc0a9bb7c60.js b/public/en.search.min.2fd0f573bd555cdf637740e915465ab9f06016cbf9762057bde7edc0a9bb7c60.js
new file mode 100644
index 0000000..1ab4755
--- /dev/null
+++ b/public/en.search.min.2fd0f573bd555cdf637740e915465ab9f06016cbf9762057bde7edc0a9bb7c60.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c47141e51cf0062faf101fb98b697b8d9c5bfdcedf2aaaf965c1e57d06953df8.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.30678426dcf6de9bec6051babfc2c54801fc5c1b7670b484092f53107d91604e.js b/public/en.search.min.30678426dcf6de9bec6051babfc2c54801fc5c1b7670b484092f53107d91604e.js
new file mode 100644
index 0000000..97fe04d
--- /dev/null
+++ b/public/en.search.min.30678426dcf6de9bec6051babfc2c54801fc5c1b7670b484092f53107d91604e.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.7128648673136f428e4e08e8623df06e4c5452a789b703f2415781ec9f13e036.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.32a0822dc4f6f1e43e47d203f8799dd8dfa5898079ad36749210a42f02f4a7e8.js b/public/en.search.min.32a0822dc4f6f1e43e47d203f8799dd8dfa5898079ad36749210a42f02f4a7e8.js
new file mode 100644
index 0000000..36b76ef
--- /dev/null
+++ b/public/en.search.min.32a0822dc4f6f1e43e47d203f8799dd8dfa5898079ad36749210a42f02f4a7e8.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.29602cad1fc3d0a6b21fe32f1fde21eec0b0505476aa0ee7cce39ce71cb8ab16.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.34c29ee7bc1bcaf25418aceaf0bd6a65272b631286bac32c67813ecf885535c4.js b/public/en.search.min.34c29ee7bc1bcaf25418aceaf0bd6a65272b631286bac32c67813ecf885535c4.js
new file mode 100644
index 0000000..84dd925
--- /dev/null
+++ b/public/en.search.min.34c29ee7bc1bcaf25418aceaf0bd6a65272b631286bac32c67813ecf885535c4.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.fa11f048f1b592c754cab90f1404f8f79d243ac5b152e6a7c6e996a672b104ea.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.35133240a2a23502c91831feb921a4f14d40cac0f1cab35a097fb4c482db014c.js b/public/en.search.min.35133240a2a23502c91831feb921a4f14d40cac0f1cab35a097fb4c482db014c.js
new file mode 100644
index 0000000..fca0400
--- /dev/null
+++ b/public/en.search.min.35133240a2a23502c91831feb921a4f14d40cac0f1cab35a097fb4c482db014c.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.667e964f283eef6242dccb5942251655146e4b0cb5e259b0803857931ce18cee.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.35195d735b20c4cc246dcc4aff29f586b03b084abb4003ec6c9cc021c9373f96.js b/public/en.search.min.35195d735b20c4cc246dcc4aff29f586b03b084abb4003ec6c9cc021c9373f96.js
new file mode 100644
index 0000000..168163f
--- /dev/null
+++ b/public/en.search.min.35195d735b20c4cc246dcc4aff29f586b03b084abb4003ec6c9cc021c9373f96.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.e1edc0ad3c25cc2662de94152abc05e9e2cc32eefd678abef7df2468cf727ec7.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.3625be2b7eae2b165390d9cf880b44dff6bf8d4d4be3b52807b1cea128f3cbc6.js b/public/en.search.min.3625be2b7eae2b165390d9cf880b44dff6bf8d4d4be3b52807b1cea128f3cbc6.js
new file mode 100644
index 0000000..58c842e
--- /dev/null
+++ b/public/en.search.min.3625be2b7eae2b165390d9cf880b44dff6bf8d4d4be3b52807b1cea128f3cbc6.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.89c0d4264a9e860a6c4cb0d8a0e8840ce657e3d0cd963becc81d1d5448c3c030.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.3701d715b592d7aa57362efee450af92be3f67098cd7816501294df2c1febcd6.js b/public/en.search.min.3701d715b592d7aa57362efee450af92be3f67098cd7816501294df2c1febcd6.js
new file mode 100644
index 0000000..c83fa10
--- /dev/null
+++ b/public/en.search.min.3701d715b592d7aa57362efee450af92be3f67098cd7816501294df2c1febcd6.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.e5ba47ebfe13fa9164ce2c9fd1f6bc2e08e4ada79161a09a7a7ac8563631e7eb.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.39b026411c3003fe2ad92344565b07b35235da22347991e2d72babf2a7967e10.js b/public/en.search.min.39b026411c3003fe2ad92344565b07b35235da22347991e2d72babf2a7967e10.js
new file mode 100644
index 0000000..988bff2
--- /dev/null
+++ b/public/en.search.min.39b026411c3003fe2ad92344565b07b35235da22347991e2d72babf2a7967e10.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.f76214aeb45811c3dbe8028a1b8eee01fc2658169071c7c5396da9c179eacce6.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.3d638e66b0ade41ca1778a84488fd1a9043a56bf45cce7f24d2b764d50bde2b4.js b/public/en.search.min.3d638e66b0ade41ca1778a84488fd1a9043a56bf45cce7f24d2b764d50bde2b4.js
new file mode 100644
index 0000000..36a7554
--- /dev/null
+++ b/public/en.search.min.3d638e66b0ade41ca1778a84488fd1a9043a56bf45cce7f24d2b764d50bde2b4.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.f12f516702011e6c3de6702318c68c98909e08078b9e4fa31f20b89deea0b5c4.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.3f74ebae5a8ad825e16a831044d31830f1a2f8af45f5ad3575bc308e0c34101f.js b/public/en.search.min.3f74ebae5a8ad825e16a831044d31830f1a2f8af45f5ad3575bc308e0c34101f.js
new file mode 100644
index 0000000..2813ab2
--- /dev/null
+++ b/public/en.search.min.3f74ebae5a8ad825e16a831044d31830f1a2f8af45f5ad3575bc308e0c34101f.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6bd8dd9b711b40d5bcda4fab6fecc6369b593e82312eb8deb610820805be14ad.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.42c6790b11812540700bfb31070f7ba65e601ecf3bb4c0ba79047e131e23229f.js b/public/en.search.min.42c6790b11812540700bfb31070f7ba65e601ecf3bb4c0ba79047e131e23229f.js
new file mode 100644
index 0000000..3a632a3
--- /dev/null
+++ b/public/en.search.min.42c6790b11812540700bfb31070f7ba65e601ecf3bb4c0ba79047e131e23229f.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.8849d2cacdbcf52d9292b8c6db6763134c296638d2450011a7cad46facae1b7e.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.42d0dec470275f02bd5f985fc7704f83da24103420d740cb9f5a6e9d8aba8096.js b/public/en.search.min.42d0dec470275f02bd5f985fc7704f83da24103420d740cb9f5a6e9d8aba8096.js
new file mode 100644
index 0000000..358badb
--- /dev/null
+++ b/public/en.search.min.42d0dec470275f02bd5f985fc7704f83da24103420d740cb9f5a6e9d8aba8096.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.304a294d6fdc89c7603281b295703c248a93d226a4caf7343d1b27f009eadaf5.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.4ac818d2214351a8277578cd4141d3c4882a2feaa1e6fb9fd3fd2c94f6909be6.js b/public/en.search.min.4ac818d2214351a8277578cd4141d3c4882a2feaa1e6fb9fd3fd2c94f6909be6.js
new file mode 100644
index 0000000..8f4ac63
--- /dev/null
+++ b/public/en.search.min.4ac818d2214351a8277578cd4141d3c4882a2feaa1e6fb9fd3fd2c94f6909be6.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.0af9bb263c482228c0bb0ef7873f8914acf1dbfcd47a07db3991689d11479374.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.4b9e6c6e09dbf9ce31d7e15fdbaefc1ef5ec01820d83545856e978bf6990ccd5.js b/public/en.search.min.4b9e6c6e09dbf9ce31d7e15fdbaefc1ef5ec01820d83545856e978bf6990ccd5.js
new file mode 100644
index 0000000..bbe5246
--- /dev/null
+++ b/public/en.search.min.4b9e6c6e09dbf9ce31d7e15fdbaefc1ef5ec01820d83545856e978bf6990ccd5.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.abe4ddbf007062948fa99a7be7a45bd457430d82fce36d01b81d3b26ad8de96d.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.4e781a2be7fbc92bbe661c4b74b4af771e3f10d20e7f925c0a90144aae3286ab.js b/public/en.search.min.4e781a2be7fbc92bbe661c4b74b4af771e3f10d20e7f925c0a90144aae3286ab.js
new file mode 100644
index 0000000..cc420aa
--- /dev/null
+++ b/public/en.search.min.4e781a2be7fbc92bbe661c4b74b4af771e3f10d20e7f925c0a90144aae3286ab.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6da35d1b7873a492a19a63b1a6d7a866eb1c69bcd4db0c41f91422935ef10597.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.50749d0e87bc3db3d9bed7f7bd70360564c25e601408f37b2c081ed8d130e6a0.js b/public/en.search.min.50749d0e87bc3db3d9bed7f7bd70360564c25e601408f37b2c081ed8d130e6a0.js
new file mode 100644
index 0000000..0afa0de
--- /dev/null
+++ b/public/en.search.min.50749d0e87bc3db3d9bed7f7bd70360564c25e601408f37b2c081ed8d130e6a0.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.d4f9e6c23843c83e22e57bb5d046c11d0eff7c3c7421f1d2e863ce7512619ae7.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.519b693064633daac2b47f2ec0e1dbb50db83e761951a087dcdbd34d0738f972.js b/public/en.search.min.519b693064633daac2b47f2ec0e1dbb50db83e761951a087dcdbd34d0738f972.js
new file mode 100644
index 0000000..5a746b3
--- /dev/null
+++ b/public/en.search.min.519b693064633daac2b47f2ec0e1dbb50db83e761951a087dcdbd34d0738f972.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.98bbde77c8be30b70ea2b56f6142d73640d8cd5c773fc19c26f15900f321438d.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.51af095858030583ba7bd4bc15e0588b0193d6424b023b9b3acb783c2942e482.js b/public/en.search.min.51af095858030583ba7bd4bc15e0588b0193d6424b023b9b3acb783c2942e482.js
new file mode 100644
index 0000000..25371e4
--- /dev/null
+++ b/public/en.search.min.51af095858030583ba7bd4bc15e0588b0193d6424b023b9b3acb783c2942e482.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.f02035e061c96821618e4891f0bd426e56274a1a58613e08e3183fad12f145de.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.569256f40a6f265b3376bc11b3e1d0f4b3079033d393d26f1014aa088d14ecfd.js b/public/en.search.min.569256f40a6f265b3376bc11b3e1d0f4b3079033d393d26f1014aa088d14ecfd.js
new file mode 100644
index 0000000..2c4584d
--- /dev/null
+++ b/public/en.search.min.569256f40a6f265b3376bc11b3e1d0f4b3079033d393d26f1014aa088d14ecfd.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.73fde574b66c5a1ae260c1ff8cab0161cab328c29957a53f4f0eded5b20e2dbd.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.586a1f75221903bf95df40855804f43cf5f0751e176764c8d928ee4ee6a11222.js b/public/en.search.min.586a1f75221903bf95df40855804f43cf5f0751e176764c8d928ee4ee6a11222.js
new file mode 100644
index 0000000..968de75
--- /dev/null
+++ b/public/en.search.min.586a1f75221903bf95df40855804f43cf5f0751e176764c8d928ee4ee6a11222.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.3647847fabb48778a5ad3e98493e2838298caf75461c71e11c85e70c64a9e60e.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.5aa9e207f1d42fcaf6b59c1fe02e761680a0c04d8daa601872c0a9fe8a41b75e.js b/public/en.search.min.5aa9e207f1d42fcaf6b59c1fe02e761680a0c04d8daa601872c0a9fe8a41b75e.js
new file mode 100644
index 0000000..bb25a87
--- /dev/null
+++ b/public/en.search.min.5aa9e207f1d42fcaf6b59c1fe02e761680a0c04d8daa601872c0a9fe8a41b75e.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c111c7ac0d90a67c67b55c838b974c84f29c50bee03187afe1288aab7e21ead7.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.5bbc5009ed6363986b719f06ede6f10345bb6400da4523f2f50f4a78c8fda23e.js b/public/en.search.min.5bbc5009ed6363986b719f06ede6f10345bb6400da4523f2f50f4a78c8fda23e.js
new file mode 100644
index 0000000..553fdd7
--- /dev/null
+++ b/public/en.search.min.5bbc5009ed6363986b719f06ede6f10345bb6400da4523f2f50f4a78c8fda23e.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.3e93869b101f92aca860e2afe0480bb2c84c4292d5bbddc6488b39aebc01fcc7.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.5d17048555b1e724af5f10053539cffc60aee2f3bea99073ad08de237cdb81b1.js b/public/en.search.min.5d17048555b1e724af5f10053539cffc60aee2f3bea99073ad08de237cdb81b1.js
new file mode 100644
index 0000000..714ef5c
--- /dev/null
+++ b/public/en.search.min.5d17048555b1e724af5f10053539cffc60aee2f3bea99073ad08de237cdb81b1.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.5bf89274dab7957218d8709c907e0da8a8c5e52a0a535f6150bd2972fb74f744.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.5df65206c3fc0eba37f11cf29d689e638d5613f66dfbf82b8e01dd9bf95ce0c9.js b/public/en.search.min.5df65206c3fc0eba37f11cf29d689e638d5613f66dfbf82b8e01dd9bf95ce0c9.js
new file mode 100644
index 0000000..7bf4bd1
--- /dev/null
+++ b/public/en.search.min.5df65206c3fc0eba37f11cf29d689e638d5613f66dfbf82b8e01dd9bf95ce0c9.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.71e69686733f1371040b0e096c71646444c02394a04d1f3d5cbd08dd169ed98c.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.5e3e547885ed92aeee216bdfba6f3612bdc1bd2f54feec3db391737928f883d9.js b/public/en.search.min.5e3e547885ed92aeee216bdfba6f3612bdc1bd2f54feec3db391737928f883d9.js
new file mode 100644
index 0000000..f98a6f5
--- /dev/null
+++ b/public/en.search.min.5e3e547885ed92aeee216bdfba6f3612bdc1bd2f54feec3db391737928f883d9.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.df4e720b1747d218c92bce0f962086b1a1f6a5166ed72528e5251de6c6ee0969.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.61c5ce8c96b8a378938f2a2946eccfaae40974310da2bf908c7f17ac7ef11b56.js b/public/en.search.min.61c5ce8c96b8a378938f2a2946eccfaae40974310da2bf908c7f17ac7ef11b56.js
new file mode 100644
index 0000000..5beb88e
--- /dev/null
+++ b/public/en.search.min.61c5ce8c96b8a378938f2a2946eccfaae40974310da2bf908c7f17ac7ef11b56.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bf7d16b96ff0e16e63078f2958be1be6badfd87c89aebb5e209c17ae29497a67.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.64df3165902afcd7f139c6dbe1089cdba2c5a05d14b42f9665824f7b14a1f3ee.js b/public/en.search.min.64df3165902afcd7f139c6dbe1089cdba2c5a05d14b42f9665824f7b14a1f3ee.js
new file mode 100644
index 0000000..f95ea4a
--- /dev/null
+++ b/public/en.search.min.64df3165902afcd7f139c6dbe1089cdba2c5a05d14b42f9665824f7b14a1f3ee.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.d14b1592fca23d09b2af02b33cc42a9d66ff059f80905c483f47d8171942ebbc.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.64e5198ac3375920bf55827b8170a773ce8b315b33d2f999b87683cd3b1f2bee.js b/public/en.search.min.64e5198ac3375920bf55827b8170a773ce8b315b33d2f999b87683cd3b1f2bee.js
new file mode 100644
index 0000000..2e1c5da
--- /dev/null
+++ b/public/en.search.min.64e5198ac3375920bf55827b8170a773ce8b315b33d2f999b87683cd3b1f2bee.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.86ecc0111a008bff2b6a31dc9f682dd09dc094acf6ded34e0942911f94a080b1.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.689ddd09ea7fc1639fdee6d8af090f6671abbdd8adeff0d10961f061c7830ba6.js b/public/en.search.min.689ddd09ea7fc1639fdee6d8af090f6671abbdd8adeff0d10961f061c7830ba6.js
new file mode 100644
index 0000000..165a0ed
--- /dev/null
+++ b/public/en.search.min.689ddd09ea7fc1639fdee6d8af090f6671abbdd8adeff0d10961f061c7830ba6.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.a406ce662dabdb1249a9fb4a1a02502ffb38b06e0a460e7a2f082cfedfe90af2.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.68e376b3c5bafe5ac0021cf4ea2fce2ea6ae432df6586c39f084478daa5aa909.js b/public/en.search.min.68e376b3c5bafe5ac0021cf4ea2fce2ea6ae432df6586c39f084478daa5aa909.js
new file mode 100644
index 0000000..263d757
--- /dev/null
+++ b/public/en.search.min.68e376b3c5bafe5ac0021cf4ea2fce2ea6ae432df6586c39f084478daa5aa909.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.26795fc419a12ac32226be7f350e7cf2096763fe62c07363914d17d8b1ac8e56.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.6c4af490195bc3fdeb7111d74cd9c9156314dd66f85c326cdca7f5e2b8e03a6d.js b/public/en.search.min.6c4af490195bc3fdeb7111d74cd9c9156314dd66f85c326cdca7f5e2b8e03a6d.js
new file mode 100644
index 0000000..8a726aa
--- /dev/null
+++ b/public/en.search.min.6c4af490195bc3fdeb7111d74cd9c9156314dd66f85c326cdca7f5e2b8e03a6d.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.a0545dae98cbf4cecedf3878fd3fa830b28f77cf9efd8699e84043162133b030.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7082a8a31f3629e294787152eaec94d9a5633bd820911b19d773a9a8539a5d08.js b/public/en.search.min.7082a8a31f3629e294787152eaec94d9a5633bd820911b19d773a9a8539a5d08.js
new file mode 100644
index 0000000..7520af8
--- /dev/null
+++ b/public/en.search.min.7082a8a31f3629e294787152eaec94d9a5633bd820911b19d773a9a8539a5d08.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.718e03783f5efc75bbb2edadb7d0244fe0660f2c3c34d47689a4817cbc1c5277.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.70d59b80a0b2f6b7e1a3668238c7c09509b2dc4ab233f2e04ef4fb96aa750a96.js b/public/en.search.min.70d59b80a0b2f6b7e1a3668238c7c09509b2dc4ab233f2e04ef4fb96aa750a96.js
new file mode 100644
index 0000000..debe80b
--- /dev/null
+++ b/public/en.search.min.70d59b80a0b2f6b7e1a3668238c7c09509b2dc4ab233f2e04ef4fb96aa750a96.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.ebd9dd9d03d1a0e52c3fc81573e722db0aeb40d0a464476c6fd31994ee85d4bc.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.70f85acc26307da1615fc02473fca459fdea2aaa77433af476d7e9f302b585c2.js b/public/en.search.min.70f85acc26307da1615fc02473fca459fdea2aaa77433af476d7e9f302b585c2.js
new file mode 100644
index 0000000..8fdb3ce
--- /dev/null
+++ b/public/en.search.min.70f85acc26307da1615fc02473fca459fdea2aaa77433af476d7e9f302b585c2.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.391017a502c7405bf4023c4b4bd23514324f48a3d4503df2789e1ee031fe8d90.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7484aa47672acf4203a554b424a42d89507df038af1cb51ecb40c716a5e8df04.js b/public/en.search.min.7484aa47672acf4203a554b424a42d89507df038af1cb51ecb40c716a5e8df04.js
new file mode 100644
index 0000000..11d9bca
--- /dev/null
+++ b/public/en.search.min.7484aa47672acf4203a554b424a42d89507df038af1cb51ecb40c716a5e8df04.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.f79486bd15a55d330b1fa3f4ef0a360fa5c542d31a568fec5b62db13d327a41a.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.755b2c4577f15fbc07ef07347d3b3144c73bbf89c489d36b8df36b82eb3647f3.js b/public/en.search.min.755b2c4577f15fbc07ef07347d3b3144c73bbf89c489d36b8df36b82eb3647f3.js
new file mode 100644
index 0000000..d4e6d77
--- /dev/null
+++ b/public/en.search.min.755b2c4577f15fbc07ef07347d3b3144c73bbf89c489d36b8df36b82eb3647f3.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.2421ceaa5fa80dc1237e0e9889791a108f8af987ef2aed3b18896ca71eba91c2.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js b/public/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js
new file mode 100644
index 0000000..fb094a2
--- /dev/null
+++ b/public/en.search.min.7684b63dace825f96f271a60d7cc545724c03b4f42cfc10ff8dbde1960090db1.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.cdd6382fdba5b5d12d1fa5fb9e8d6c93f835666d942dc95b2d6f8e9a8f9aff06.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.77cebe39b7952ba196a61987eabf00157d46f75471ef303fd1f3d327c0071c1f.js b/public/en.search.min.77cebe39b7952ba196a61987eabf00157d46f75471ef303fd1f3d327c0071c1f.js
new file mode 100644
index 0000000..0d8fd9b
--- /dev/null
+++ b/public/en.search.min.77cebe39b7952ba196a61987eabf00157d46f75471ef303fd1f3d327c0071c1f.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.97b0bb8f87c4d1219d3160d213583251311b144cea0763e2283cf364553113f2.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.78219bfc481daf5b357956a7eb4e195236f9540d03ad70187a7adbffb60b43c8.js b/public/en.search.min.78219bfc481daf5b357956a7eb4e195236f9540d03ad70187a7adbffb60b43c8.js
new file mode 100644
index 0000000..8c0b929
--- /dev/null
+++ b/public/en.search.min.78219bfc481daf5b357956a7eb4e195236f9540d03ad70187a7adbffb60b43c8.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.b25c9a14aa028cd957e5f64d43b8ee801354d45cc5867530a965c6dcda605ebf.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7951d01125f67427fa6732008921c6f26a53d45254eaf1e43afa9b5466466002.js b/public/en.search.min.7951d01125f67427fa6732008921c6f26a53d45254eaf1e43afa9b5466466002.js
new file mode 100644
index 0000000..68fe6ca
--- /dev/null
+++ b/public/en.search.min.7951d01125f67427fa6732008921c6f26a53d45254eaf1e43afa9b5466466002.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.fefbbafff9709c04c0513eb160c0dcf2613bb13447e9dc11b095c6e4f9b9674c.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7b4568ecfa9b6172129f87a00fee4bb35bbe734e09d62a0edbfdb642c565b277.js b/public/en.search.min.7b4568ecfa9b6172129f87a00fee4bb35bbe734e09d62a0edbfdb642c565b277.js
new file mode 100644
index 0000000..31288ce
--- /dev/null
+++ b/public/en.search.min.7b4568ecfa9b6172129f87a00fee4bb35bbe734e09d62a0edbfdb642c565b277.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.94968468ff8b46624548373c43591a7a34c3906249e666635e5e5712bc39b4cd.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7c94624103b8e8bec52f50ad70b35a1d88c73934c5dac57c428daa5f7174958e.js b/public/en.search.min.7c94624103b8e8bec52f50ad70b35a1d88c73934c5dac57c428daa5f7174958e.js
new file mode 100644
index 0000000..7e4aa1b
--- /dev/null
+++ b/public/en.search.min.7c94624103b8e8bec52f50ad70b35a1d88c73934c5dac57c428daa5f7174958e.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.e21491cf6b15f1b52f0253f4a135119405aca3c1d652dc2487600741a7256446.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7dc2dd67285cfc04a59bb94520a7190e16bde7ee2010137ee171941ab301c492.js b/public/en.search.min.7dc2dd67285cfc04a59bb94520a7190e16bde7ee2010137ee171941ab301c492.js
new file mode 100644
index 0000000..9f70ec5
--- /dev/null
+++ b/public/en.search.min.7dc2dd67285cfc04a59bb94520a7190e16bde7ee2010137ee171941ab301c492.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.445d8a4c1c2cfc514578b8de5e1a255447e5f3ed79c02231fa561f469d6fb4c0.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7f0ba8a936636c7e80ccebdfee478f9f69409943b54831d0b1ae7e72ae91c57c.js b/public/en.search.min.7f0ba8a936636c7e80ccebdfee478f9f69409943b54831d0b1ae7e72ae91c57c.js
new file mode 100644
index 0000000..7c0ae00
--- /dev/null
+++ b/public/en.search.min.7f0ba8a936636c7e80ccebdfee478f9f69409943b54831d0b1ae7e72ae91c57c.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.ce8f33773aa20e2c8eb5535db54d153816affa6e897b7fef2a8a5bc80e8912d8.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.7f16c1879d39c99a913184608e1729dbaddc2478196ced444a82bdc2a2fd514c.js b/public/en.search.min.7f16c1879d39c99a913184608e1729dbaddc2478196ced444a82bdc2a2fd514c.js
new file mode 100644
index 0000000..21164b3
--- /dev/null
+++ b/public/en.search.min.7f16c1879d39c99a913184608e1729dbaddc2478196ced444a82bdc2a2fd514c.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.5fc846aaf33df5a2c9bfbc26c1f95a12084d32e0442d5a1c8f6c398100923946.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.808c49a68509b33a4893e1e7e2dac1a844d1df6b692a21aff7a18690f8e17fb0.js b/public/en.search.min.808c49a68509b33a4893e1e7e2dac1a844d1df6b692a21aff7a18690f8e17fb0.js
new file mode 100644
index 0000000..2da1029
--- /dev/null
+++ b/public/en.search.min.808c49a68509b33a4893e1e7e2dac1a844d1df6b692a21aff7a18690f8e17fb0.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6445f0a0beb9c7f367316a2192ae26de3fb58161f9edddfc9c94620923320aa7.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.80eb5454a2e5ca2bced97589678076987ac33781454a3a12b20e65add02060b9.js b/public/en.search.min.80eb5454a2e5ca2bced97589678076987ac33781454a3a12b20e65add02060b9.js
new file mode 100644
index 0000000..d942828
--- /dev/null
+++ b/public/en.search.min.80eb5454a2e5ca2bced97589678076987ac33781454a3a12b20e65add02060b9.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.7d9dd6105ae5375618d9d0241abf45e8c1dd525876f5df2f217a332e7b698b01.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.824769706f1cb7fe17475bf066534006297513d7d5b54e210d446f99988746ee.js b/public/en.search.min.824769706f1cb7fe17475bf066534006297513d7d5b54e210d446f99988746ee.js
new file mode 100644
index 0000000..b93ee31
--- /dev/null
+++ b/public/en.search.min.824769706f1cb7fe17475bf066534006297513d7d5b54e210d446f99988746ee.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bf76fe20f9f42249feacb637fc7dd0e32c62bc43b08e4db4f825ce94b0cfd608.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.82626a305de4128c9668eeb061c1472b4662bd51e976ece4ee72a21a5b304d7f.js b/public/en.search.min.82626a305de4128c9668eeb061c1472b4662bd51e976ece4ee72a21a5b304d7f.js
new file mode 100644
index 0000000..5785476
--- /dev/null
+++ b/public/en.search.min.82626a305de4128c9668eeb061c1472b4662bd51e976ece4ee72a21a5b304d7f.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c59b621fa81c9a3047dc1dfc53456d494adea3c6fdee8ceef49f1ae80c8dc306.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.8267a5d7dc5224a1e37671902ac909535d5a122007d77322998062e5e6244341.js b/public/en.search.min.8267a5d7dc5224a1e37671902ac909535d5a122007d77322998062e5e6244341.js
new file mode 100644
index 0000000..d17dd93
--- /dev/null
+++ b/public/en.search.min.8267a5d7dc5224a1e37671902ac909535d5a122007d77322998062e5e6244341.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c4a49f772fe1c88f3394a5761bcc3b6433a46cc0a8709d3ace6f55fbf48b6a32.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.8351b5cf290f8354b2acb5458f4ea8ec9bdcc0fc15835306aea04a833476d220.js b/public/en.search.min.8351b5cf290f8354b2acb5458f4ea8ec9bdcc0fc15835306aea04a833476d220.js
new file mode 100644
index 0000000..311790a
--- /dev/null
+++ b/public/en.search.min.8351b5cf290f8354b2acb5458f4ea8ec9bdcc0fc15835306aea04a833476d220.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.b7c7a96f8d3894b028594db37e5f6ad4465953a6469ea180e4ef2c8c8cbd8ae2.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.869b80bd1897e92c829bb12587a6ffc62a6da2669464b4b5c56f8772e36caed5.js b/public/en.search.min.869b80bd1897e92c829bb12587a6ffc62a6da2669464b4b5c56f8772e36caed5.js
new file mode 100644
index 0000000..0a42562
--- /dev/null
+++ b/public/en.search.min.869b80bd1897e92c829bb12587a6ffc62a6da2669464b4b5c56f8772e36caed5.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.1556011805b59dec4ab3d9a0edf74207a27381ebeed46abd8f9d36faca646b33.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.89098bbaa3295c079f7971528665b54616525599eeb7ee852fb5a9f74b13293d.js b/public/en.search.min.89098bbaa3295c079f7971528665b54616525599eeb7ee852fb5a9f74b13293d.js
new file mode 100644
index 0000000..a6eef7a
--- /dev/null
+++ b/public/en.search.min.89098bbaa3295c079f7971528665b54616525599eeb7ee852fb5a9f74b13293d.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.b8694d7f275c2bf95c26f68f7835d3df004cd5467cd751f7325ec7664324a5b8.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.8c2609c5dcc885f793f4d2e82584163518fb1c21fa2d48342aac34580ad01e05.js b/public/en.search.min.8c2609c5dcc885f793f4d2e82584163518fb1c21fa2d48342aac34580ad01e05.js
new file mode 100644
index 0000000..732e6c2
--- /dev/null
+++ b/public/en.search.min.8c2609c5dcc885f793f4d2e82584163518fb1c21fa2d48342aac34580ad01e05.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.894e3518b4efd7e1b26bca6ecc152fa01a89ed8be9a761723befcefe87497135.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.8d0a132a99798b8691c357719af3b3a275bb8c60d8c350cb7c12b6403bc6d8a6.js b/public/en.search.min.8d0a132a99798b8691c357719af3b3a275bb8c60d8c350cb7c12b6403bc6d8a6.js
new file mode 100644
index 0000000..2e725e0
--- /dev/null
+++ b/public/en.search.min.8d0a132a99798b8691c357719af3b3a275bb8c60d8c350cb7c12b6403bc6d8a6.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.772214b603eccaf257495902ca09daa59bc1f8db14bf27672640d0ba4b0a5637.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.8e6b6a1f9ae0bcc6f96160ef636cee53154df37bc76d8e81ed30cbb48bd8fa14.js b/public/en.search.min.8e6b6a1f9ae0bcc6f96160ef636cee53154df37bc76d8e81ed30cbb48bd8fa14.js
new file mode 100644
index 0000000..48b76af
--- /dev/null
+++ b/public/en.search.min.8e6b6a1f9ae0bcc6f96160ef636cee53154df37bc76d8e81ed30cbb48bd8fa14.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.b3397ef9eef083de5eb7c1237cab9a101c29b65506def9dbcb2c9419d4600a95.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.8f32e5112d9987b318c16bbdbd9f3f59c754d7695362548a32efd243004febb5.js b/public/en.search.min.8f32e5112d9987b318c16bbdbd9f3f59c754d7695362548a32efd243004febb5.js
new file mode 100644
index 0000000..9089b4f
--- /dev/null
+++ b/public/en.search.min.8f32e5112d9987b318c16bbdbd9f3f59c754d7695362548a32efd243004febb5.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.b22d38864b7bb570f898add170d5d604d0802cceec1e58355361d744d59891d6.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.92c9a8c3b59827823cb02512ec4ea025f3b312748488a529da3a6f3e3ea88a09.js b/public/en.search.min.92c9a8c3b59827823cb02512ec4ea025f3b312748488a529da3a6f3e3ea88a09.js
new file mode 100644
index 0000000..c827833
--- /dev/null
+++ b/public/en.search.min.92c9a8c3b59827823cb02512ec4ea025f3b312748488a529da3a6f3e3ea88a09.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.b86107c2283ccf4dcc7c1c084d4b0da505310b8bc00c5d213273b3e64b8a82c6.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.94107bc47e08b24d9a4a6ceab8e3e2f3c59ad14dc6459778888f766fd029a8e8.js b/public/en.search.min.94107bc47e08b24d9a4a6ceab8e3e2f3c59ad14dc6459778888f766fd029a8e8.js
new file mode 100644
index 0000000..cc4bc9b
--- /dev/null
+++ b/public/en.search.min.94107bc47e08b24d9a4a6ceab8e3e2f3c59ad14dc6459778888f766fd029a8e8.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.11970372873f60a48f95e439cffeb1c837eb8987f710edb230037cde896c3f5f.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js b/public/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js
new file mode 100644
index 0000000..951831b
--- /dev/null
+++ b/public/en.search.min.95666a43b0819ed293aaaeae32ef63e32d40873b034c7c5de25619a08538090b.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.154f7a8647a8102e314414ab527155ac0269d10f548c9349f17900f8c7f83371.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.97925bef4fbbc0d56e68073475805f804ff0db6941b67d0a4097ade2ce57d595.js b/public/en.search.min.97925bef4fbbc0d56e68073475805f804ff0db6941b67d0a4097ade2ce57d595.js
new file mode 100644
index 0000000..a162745
--- /dev/null
+++ b/public/en.search.min.97925bef4fbbc0d56e68073475805f804ff0db6941b67d0a4097ade2ce57d595.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.a8a9e17cca1b7fb9a055d3771c1fe3d65160bfc63090e47f3c1c06ec3746066f.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.99afd73ef8b8f2e8c49bd47fa70c316bb594e105fabecd7fd3a441ce7174be3e.js b/public/en.search.min.99afd73ef8b8f2e8c49bd47fa70c316bb594e105fabecd7fd3a441ce7174be3e.js
new file mode 100644
index 0000000..063a79d
--- /dev/null
+++ b/public/en.search.min.99afd73ef8b8f2e8c49bd47fa70c316bb594e105fabecd7fd3a441ce7174be3e.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.7f321d667fb9e48f584f17ac1e71faba6cd7df99151431b63318e328cafbffd8.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.99ed48400dde8fe37801b70d20f235738fe068f2586726719253ddb97354742c.js b/public/en.search.min.99ed48400dde8fe37801b70d20f235738fe068f2586726719253ddb97354742c.js
new file mode 100644
index 0000000..fc0609e
--- /dev/null
+++ b/public/en.search.min.99ed48400dde8fe37801b70d20f235738fe068f2586726719253ddb97354742c.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.7337c013d8f9b84d3b7fd99a0f53f1c23dd63f493ee6aec2551998b717186cee.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.9c0d67c37d7ab5a44ca291865accd872d300ce864e9b55b1324f1f6adc725ddf.js b/public/en.search.min.9c0d67c37d7ab5a44ca291865accd872d300ce864e9b55b1324f1f6adc725ddf.js
new file mode 100644
index 0000000..fff904e
--- /dev/null
+++ b/public/en.search.min.9c0d67c37d7ab5a44ca291865accd872d300ce864e9b55b1324f1f6adc725ddf.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.801a6a757cd9a4a9499d57cffe098df09a4a43689412b4091368c64f1b9ea204.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.9cbedddc2541fc0cedcabce21e6a94e85e2698b04566e231ef5d91d6cd8c1011.js b/public/en.search.min.9cbedddc2541fc0cedcabce21e6a94e85e2698b04566e231ef5d91d6cd8c1011.js
new file mode 100644
index 0000000..8e7bd78
--- /dev/null
+++ b/public/en.search.min.9cbedddc2541fc0cedcabce21e6a94e85e2698b04566e231ef5d91d6cd8c1011.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6546c45c925b5659b8d98ca778e860d2f02ad8c70b75ee5864ded5adc3a67fa9.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.9db4ddedcc9ac99b93862fe601a7eab54221e49f7326291bc8463880ce04c519.js b/public/en.search.min.9db4ddedcc9ac99b93862fe601a7eab54221e49f7326291bc8463880ce04c519.js
new file mode 100644
index 0000000..1592a9c
--- /dev/null
+++ b/public/en.search.min.9db4ddedcc9ac99b93862fe601a7eab54221e49f7326291bc8463880ce04c519.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.4675156f2f815ac19439aba9887f4797c070e5b270ba38de6ccc3a4818affab8.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.a16e783d72e3615fe1f27052217b56c087f61a5f2df018e7f36c72280ce25b73.js b/public/en.search.min.a16e783d72e3615fe1f27052217b56c087f61a5f2df018e7f36c72280ce25b73.js
new file mode 100644
index 0000000..60625b1
--- /dev/null
+++ b/public/en.search.min.a16e783d72e3615fe1f27052217b56c087f61a5f2df018e7f36c72280ce25b73.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.1be1adeec26200029d2af9a07cf8a54f33223e7e0614671cc64d036a8bd5a8f3.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.a48047ea0271f766b04e88802243bb2965f6b1b1111af1adc118e5de853b9d45.js b/public/en.search.min.a48047ea0271f766b04e88802243bb2965f6b1b1111af1adc118e5de853b9d45.js
new file mode 100644
index 0000000..9c078a8
--- /dev/null
+++ b/public/en.search.min.a48047ea0271f766b04e88802243bb2965f6b1b1111af1adc118e5de853b9d45.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.a38bacd2505c23ef42f1f9abd28ed86f95ac0dff3da3ea7a7c40e461bec826e0.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.a496ffe34d054960d0c8122994ee30236ad01aa8bc80a1d270c30f34f0c02575.js b/public/en.search.min.a496ffe34d054960d0c8122994ee30236ad01aa8bc80a1d270c30f34f0c02575.js
new file mode 100644
index 0000000..23ff11f
--- /dev/null
+++ b/public/en.search.min.a496ffe34d054960d0c8122994ee30236ad01aa8bc80a1d270c30f34f0c02575.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.029e88f856b43e6755e9b4b8eda4badc7b7913d64a4ed055dea05c5b2d04446e.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.a5d7cec1e9459342629ea16c410e23dfda0b26e6804a64931ff6365698678411.js b/public/en.search.min.a5d7cec1e9459342629ea16c410e23dfda0b26e6804a64931ff6365698678411.js
new file mode 100644
index 0000000..e31195d
--- /dev/null
+++ b/public/en.search.min.a5d7cec1e9459342629ea16c410e23dfda0b26e6804a64931ff6365698678411.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.61d5e44622e0ab52daa1d875fd37dba3ff5f0c40dd4fb0c1c0ee9258275e496d.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.aa3780aa295cb80b2b4d886afb2b094ef8298e67bc982a98497133eee20eff0d.js b/public/en.search.min.aa3780aa295cb80b2b4d886afb2b094ef8298e67bc982a98497133eee20eff0d.js
new file mode 100644
index 0000000..25a31b8
--- /dev/null
+++ b/public/en.search.min.aa3780aa295cb80b2b4d886afb2b094ef8298e67bc982a98497133eee20eff0d.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c0bc7529c23a3bec1b623fb2de6635ceec6db987683d966ca13e6f16263b49ae.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.ab94619d4e5ba35ac9d0b3acfec0d681ee7a1ef36cc383559e3ec9721feef328.js b/public/en.search.min.ab94619d4e5ba35ac9d0b3acfec0d681ee7a1ef36cc383559e3ec9721feef328.js
new file mode 100644
index 0000000..fbee9f4
--- /dev/null
+++ b/public/en.search.min.ab94619d4e5ba35ac9d0b3acfec0d681ee7a1ef36cc383559e3ec9721feef328.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6af851c1ac65c501a9485c83928656edca91be2fec79d3d2492fb610fcee29c0.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.ae2f01b3fbdb48b1b74fe64553d1e9b7a99959e51a535976b633c858f9fb5ce0.js b/public/en.search.min.ae2f01b3fbdb48b1b74fe64553d1e9b7a99959e51a535976b633c858f9fb5ce0.js
new file mode 100644
index 0000000..ca81528
--- /dev/null
+++ b/public/en.search.min.ae2f01b3fbdb48b1b74fe64553d1e9b7a99959e51a535976b633c858f9fb5ce0.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.2fcc4604322f1c298722042c62acc0150432fc6de5d2a5d242641dad06adb3d2.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.ae45270e7aba08d7d38ad204ea92a05a378ad5c114f8eae6c5402b22bc14dfb5.js b/public/en.search.min.ae45270e7aba08d7d38ad204ea92a05a378ad5c114f8eae6c5402b22bc14dfb5.js
new file mode 100644
index 0000000..d1539fb
--- /dev/null
+++ b/public/en.search.min.ae45270e7aba08d7d38ad204ea92a05a378ad5c114f8eae6c5402b22bc14dfb5.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.e34a9d4facccf3d3bb7b409858cb73416d0abd3e5180a5f043f8db24f7064a32.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js b/public/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js
new file mode 100644
index 0000000..870d17c
--- /dev/null
+++ b/public/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.0745cdc6706f1058d039ebc7a5133c574c68fffa371091bc49bb66cd064a724a.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.b0b6bbf515b5fa343ec49d730ec6980f79e4bb567b5c54f9c4b20ceb722e70c9.js b/public/en.search.min.b0b6bbf515b5fa343ec49d730ec6980f79e4bb567b5c54f9c4b20ceb722e70c9.js
new file mode 100644
index 0000000..029af1c
--- /dev/null
+++ b/public/en.search.min.b0b6bbf515b5fa343ec49d730ec6980f79e4bb567b5c54f9c4b20ceb722e70c9.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.7e95d980c3282e4b0be2b9adec314ebd13db1bc4a0ed4a1da8af101c8f211c29.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.b499a172a035273577e04d29d7214fd2e2ca8f8291c60b35c9378d5a1b429005.js b/public/en.search.min.b499a172a035273577e04d29d7214fd2e2ca8f8291c60b35c9378d5a1b429005.js
new file mode 100644
index 0000000..e723469
--- /dev/null
+++ b/public/en.search.min.b499a172a035273577e04d29d7214fd2e2ca8f8291c60b35c9378d5a1b429005.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.9a42dad56111450c33e67bcedc9fdde765cd64ce3d49651e2b9b9bc9959b1f61.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.b77799106eab9f2b103e5788a8d7e10518349da630e042bd591e6403d1febfe8.js b/public/en.search.min.b77799106eab9f2b103e5788a8d7e10518349da630e042bd591e6403d1febfe8.js
new file mode 100644
index 0000000..96df5e9
--- /dev/null
+++ b/public/en.search.min.b77799106eab9f2b103e5788a8d7e10518349da630e042bd591e6403d1febfe8.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.ab470f4d6d2e6dc40dbb80009279282d69a20863acd3c536e7a03dc912bc3b9c.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.b8573861646135a8fbed93dddfaa6309b473c03ab2f9aac665d2a1a661a400bc.js b/public/en.search.min.b8573861646135a8fbed93dddfaa6309b473c03ab2f9aac665d2a1a661a400bc.js
new file mode 100644
index 0000000..899be5c
--- /dev/null
+++ b/public/en.search.min.b8573861646135a8fbed93dddfaa6309b473c03ab2f9aac665d2a1a661a400bc.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.048ef4df4358980e4f119d4036c3fc0e6a6a21fd9d2158798630e30fccbfa641.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.b8f69ae3247a43bdf7c17b8ce3b719cdc738265dedc0378886b313fd97712378.js b/public/en.search.min.b8f69ae3247a43bdf7c17b8ce3b719cdc738265dedc0378886b313fd97712378.js
new file mode 100644
index 0000000..7dc93ea
--- /dev/null
+++ b/public/en.search.min.b8f69ae3247a43bdf7c17b8ce3b719cdc738265dedc0378886b313fd97712378.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c2f86be8bf35861faf90fe2214bb523b50b018784c4d43d3b19640c6721f8968.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.b9e2e62d90449c748c360995f89a81b2a0fda9294d30d1a3f231355c31d2195b.js b/public/en.search.min.b9e2e62d90449c748c360995f89a81b2a0fda9294d30d1a3f231355c31d2195b.js
new file mode 100644
index 0000000..60eb115
--- /dev/null
+++ b/public/en.search.min.b9e2e62d90449c748c360995f89a81b2a0fda9294d30d1a3f231355c31d2195b.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.55786e98b357d542b9a9f1ebdc64f3a9cef1bfa7e7b929136564bec7b8d38e13.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.ba037690b2aae1c34b8d6879ae08787d7e70aea6379e4b99a1ff9bed0a35412a.js b/public/en.search.min.ba037690b2aae1c34b8d6879ae08787d7e70aea6379e4b99a1ff9bed0a35412a.js
new file mode 100644
index 0000000..5efb3fe
--- /dev/null
+++ b/public/en.search.min.ba037690b2aae1c34b8d6879ae08787d7e70aea6379e4b99a1ff9bed0a35412a.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c225043b57c5852126722f2f3e68ac819e50499408f143203e44e3d42c1cd049.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.bc8a730c38778da6dd3c795c63c78f44391ac404d640e3016fae9ac51593b4cb.js b/public/en.search.min.bc8a730c38778da6dd3c795c63c78f44391ac404d640e3016fae9ac51593b4cb.js
new file mode 100644
index 0000000..000c9c5
--- /dev/null
+++ b/public/en.search.min.bc8a730c38778da6dd3c795c63c78f44391ac404d640e3016fae9ac51593b4cb.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.96a560e13c0e945062164a0eede07db68559e25265ea9a4daeced86b305b711f.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.bdeca18d14b9171f760675456af5b0f992080deadf61103473ddc717f34310d1.js b/public/en.search.min.bdeca18d14b9171f760675456af5b0f992080deadf61103473ddc717f34310d1.js
new file mode 100644
index 0000000..08c50e6
--- /dev/null
+++ b/public/en.search.min.bdeca18d14b9171f760675456af5b0f992080deadf61103473ddc717f34310d1.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.dbdc6ea5d40b528b04cd5caa2d60eaddbb9451c7daeb9c5e1d3454a0908b430b.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.c13a16ae805c817d5bb47b5e2484085f8a309d0b846234937e58fdb7c6070b2f.js b/public/en.search.min.c13a16ae805c817d5bb47b5e2484085f8a309d0b846234937e58fdb7c6070b2f.js
new file mode 100644
index 0000000..ec8e4b7
--- /dev/null
+++ b/public/en.search.min.c13a16ae805c817d5bb47b5e2484085f8a309d0b846234937e58fdb7c6070b2f.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.f063290de814ec014ceed7c8c08ab71faa267910f84e401902f200d7320784cc.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.c36b0af8d46c12500c018e4f975ab5780930ee1fd43c4f84ec507446218d4752.js b/public/en.search.min.c36b0af8d46c12500c018e4f975ab5780930ee1fd43c4f84ec507446218d4752.js
new file mode 100644
index 0000000..bd1a9f2
--- /dev/null
+++ b/public/en.search.min.c36b0af8d46c12500c018e4f975ab5780930ee1fd43c4f84ec507446218d4752.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6499862a64d277340e205c881fe65582ab1f36f9eefc09396ef53bdac0d7317b.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.c37dee990b604bcf09bf2b1ac7b3d359663e9e1b0be153d0c337a02f6bdd3423.js b/public/en.search.min.c37dee990b604bcf09bf2b1ac7b3d359663e9e1b0be153d0c337a02f6bdd3423.js
new file mode 100644
index 0000000..38fbf0a
--- /dev/null
+++ b/public/en.search.min.c37dee990b604bcf09bf2b1ac7b3d359663e9e1b0be153d0c337a02f6bdd3423.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c00e23b94e00aef0ef43af7fddf4b6251be839876c1a0db228a0617d6ec5f446.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.c52da93774ced0b779087bc46b608b93aa09fc490e972f1da53c931c95275982.js b/public/en.search.min.c52da93774ced0b779087bc46b608b93aa09fc490e972f1da53c931c95275982.js
new file mode 100644
index 0000000..3e08ada
--- /dev/null
+++ b/public/en.search.min.c52da93774ced0b779087bc46b608b93aa09fc490e972f1da53c931c95275982.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.91fd0cbad6736a636b94cfca254e3a815f6627e00d11557be52a99e5b1a44231.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.d40d3e3d76eff60f795b62063fce4b8f5fa50bfde284a37673f3197b4946da4a.js b/public/en.search.min.d40d3e3d76eff60f795b62063fce4b8f5fa50bfde284a37673f3197b4946da4a.js
new file mode 100644
index 0000000..43272a4
--- /dev/null
+++ b/public/en.search.min.d40d3e3d76eff60f795b62063fce4b8f5fa50bfde284a37673f3197b4946da4a.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.ec643153ef99305dd7d4bb0242b33951252ef9e1c92a59b8ff5f21f7e621b9d7.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.d48a86e8604c49f62d363fab3d0bc4b0279ab8b77869962c31524132c3e6656a.js b/public/en.search.min.d48a86e8604c49f62d363fab3d0bc4b0279ab8b77869962c31524132c3e6656a.js
new file mode 100644
index 0000000..1c73537
--- /dev/null
+++ b/public/en.search.min.d48a86e8604c49f62d363fab3d0bc4b0279ab8b77869962c31524132c3e6656a.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.de70110fecda8d49639e7b6369078ebc07d9f851d5768274aa605fb033205f8f.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.d711d7f6df0def3edacc84bbc37235fc85d6108172076e79c3f40457143e3e18.js b/public/en.search.min.d711d7f6df0def3edacc84bbc37235fc85d6108172076e79c3f40457143e3e18.js
new file mode 100644
index 0000000..160bd4b
--- /dev/null
+++ b/public/en.search.min.d711d7f6df0def3edacc84bbc37235fc85d6108172076e79c3f40457143e3e18.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bbc5e819b180288b63890162d58d58553187d1fa7d90555abe3b69363269277b.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.d9c46255f8596968a96aa9ca7d0f29f2900440db29a7eeb4715dd2dc057e8213.js b/public/en.search.min.d9c46255f8596968a96aa9ca7d0f29f2900440db29a7eeb4715dd2dc057e8213.js
new file mode 100644
index 0000000..8bba759
--- /dev/null
+++ b/public/en.search.min.d9c46255f8596968a96aa9ca7d0f29f2900440db29a7eeb4715dd2dc057e8213.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bf22df4eaf43889158756edc9fc7e00ff81fd4ab33add9c82975300375f2a593.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.dc4a3704c29eed52558a674d00acd6704d7ec37b088c744fff93db2ce6371e50.js b/public/en.search.min.dc4a3704c29eed52558a674d00acd6704d7ec37b088c744fff93db2ce6371e50.js
new file mode 100644
index 0000000..fe139f9
--- /dev/null
+++ b/public/en.search.min.dc4a3704c29eed52558a674d00acd6704d7ec37b088c744fff93db2ce6371e50.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.83c0aed0d8ecb36136e091e4caa0b03bd83d734aaa6dabe48149f256251d788b.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.dd7585aa780207ec28b8c9eb7353b201943637284711d56d0c86d7b640b1cbb1.js b/public/en.search.min.dd7585aa780207ec28b8c9eb7353b201943637284711d56d0c86d7b640b1cbb1.js
new file mode 100644
index 0000000..041c806
--- /dev/null
+++ b/public/en.search.min.dd7585aa780207ec28b8c9eb7353b201943637284711d56d0c86d7b640b1cbb1.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bad9fe840129bc1af5af801d913f6e4571b96d65a99e8f22c84a185c8b2cb035.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.de13c7a03a82e1e1c3e3b691a04fd17421cae63011231a8a1f61e6864e703c21.js b/public/en.search.min.de13c7a03a82e1e1c3e3b691a04fd17421cae63011231a8a1f61e6864e703c21.js
new file mode 100644
index 0000000..1246eba
--- /dev/null
+++ b/public/en.search.min.de13c7a03a82e1e1c3e3b691a04fd17421cae63011231a8a1f61e6864e703c21.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.7830d52e2f16f74b9b7c45522763a41e206663e7aeb268e1ffe69f1610e3a6c4.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.df0eed5f0236d46ff083eb83a00462f5d3f36020a3b154d9a9f5dd703e219689.js b/public/en.search.min.df0eed5f0236d46ff083eb83a00462f5d3f36020a3b154d9a9f5dd703e219689.js
new file mode 100644
index 0000000..0fff744
--- /dev/null
+++ b/public/en.search.min.df0eed5f0236d46ff083eb83a00462f5d3f36020a3b154d9a9f5dd703e219689.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bf0a000c9c7900b4bbb10dd12183db31d89992a82f52bbfbd3f79483047786d1.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.df3d77169b328722c21fb2f931d7494bb15a9f538a6bf4ab1d88f83b8c2c9570.js b/public/en.search.min.df3d77169b328722c21fb2f931d7494bb15a9f538a6bf4ab1d88f83b8c2c9570.js
new file mode 100644
index 0000000..c900a6e
--- /dev/null
+++ b/public/en.search.min.df3d77169b328722c21fb2f931d7494bb15a9f538a6bf4ab1d88f83b8c2c9570.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.66c5937d497e0ccf53cbc616e18b843aa5f4347ba038182bf0293ad11fa91ccb.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.df6106ea2264133050e37ea1e4b59e6d94c58713631c02368af511452b8138f0.js b/public/en.search.min.df6106ea2264133050e37ea1e4b59e6d94c58713631c02368af511452b8138f0.js
new file mode 100644
index 0000000..58a8b8e
--- /dev/null
+++ b/public/en.search.min.df6106ea2264133050e37ea1e4b59e6d94c58713631c02368af511452b8138f0.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.cffa6a43531f5ca08beb6e22130e6263b113e49c35e26912602aa5188313d167.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.e0fc51a7042a1fe031162f71d818ec60751c4576b1a88219906c722bd527d9cc.js b/public/en.search.min.e0fc51a7042a1fe031162f71d818ec60751c4576b1a88219906c722bd527d9cc.js
new file mode 100644
index 0000000..28b4044
--- /dev/null
+++ b/public/en.search.min.e0fc51a7042a1fe031162f71d818ec60751c4576b1a88219906c722bd527d9cc.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.1eeb3810eb70dcd6d62a8495adb9ce9f941e9def9bfe3a1c51c48c886690209c.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.e1452005bf529ada3f821e8b5bd588e6ee798c61af840b239f70fd17a926a1f4.js b/public/en.search.min.e1452005bf529ada3f821e8b5bd588e6ee798c61af840b239f70fd17a926a1f4.js
new file mode 100644
index 0000000..1556096
--- /dev/null
+++ b/public/en.search.min.e1452005bf529ada3f821e8b5bd588e6ee798c61af840b239f70fd17a926a1f4.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.00e40082f8fc8cb6a922a8b64004e43073b3529d0b5cfddc90692fa868fc35c2.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.e3b4a63229fceb760e86ab1b412f43ff34c01a547f0276a0d8efd431c62bcb2b.js b/public/en.search.min.e3b4a63229fceb760e86ab1b412f43ff34c01a547f0276a0d8efd431c62bcb2b.js
new file mode 100644
index 0000000..4d1db26
--- /dev/null
+++ b/public/en.search.min.e3b4a63229fceb760e86ab1b412f43ff34c01a547f0276a0d8efd431c62bcb2b.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.565be0a4658598fc23d864f16a924b0d9c2324950165061c798e944d6c336f53.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.e56c3fa5faa3782d354a13ac3c75eaff32e28b0e62306ab2969b25d6bc2947eb.js b/public/en.search.min.e56c3fa5faa3782d354a13ac3c75eaff32e28b0e62306ab2969b25d6bc2947eb.js
new file mode 100644
index 0000000..b1fba67
--- /dev/null
+++ b/public/en.search.min.e56c3fa5faa3782d354a13ac3c75eaff32e28b0e62306ab2969b25d6bc2947eb.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.81905bc2c4cd8c52929d625a6633dbf5be644a50ef023e6ed6d8403bb0e3af8f.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.e84cd68997bc541860a11a9ebcd8369a884cca99874a976ffc2546f5a6ccfbe6.js b/public/en.search.min.e84cd68997bc541860a11a9ebcd8369a884cca99874a976ffc2546f5a6ccfbe6.js
new file mode 100644
index 0000000..19f7184
--- /dev/null
+++ b/public/en.search.min.e84cd68997bc541860a11a9ebcd8369a884cca99874a976ffc2546f5a6ccfbe6.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c88788fee0bbc6f8d202ce2ad9652258561894883a4c2b22dae8ddae27595333.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.e925ade840e4ad5ac5b6376d696b85b9950aa292222a1e0b0a17a6662af7fcc2.js b/public/en.search.min.e925ade840e4ad5ac5b6376d696b85b9950aa292222a1e0b0a17a6662af7fcc2.js
new file mode 100644
index 0000000..8f9c07e
--- /dev/null
+++ b/public/en.search.min.e925ade840e4ad5ac5b6376d696b85b9950aa292222a1e0b0a17a6662af7fcc2.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.5ff007a54a084d92bf0714481a15343d45fc205cdcfe5f00647dc98c5d553336.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.ed0ee1494386afa2c9e0689a3c39ba4de6ae0a0bbbf05774e992bf66b5bf7eec.js b/public/en.search.min.ed0ee1494386afa2c9e0689a3c39ba4de6ae0a0bbbf05774e992bf66b5bf7eec.js
new file mode 100644
index 0000000..a242f39
--- /dev/null
+++ b/public/en.search.min.ed0ee1494386afa2c9e0689a3c39ba4de6ae0a0bbbf05774e992bf66b5bf7eec.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.981a159b15887545282b1b960b4b0a1e5ae1ce30723a81e6e9cd45328ea1d46c.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.ed4281223476397821bb0f574a22254cb0af857a6c6f5f018e516b51695dd3c2.js b/public/en.search.min.ed4281223476397821bb0f574a22254cb0af857a6c6f5f018e516b51695dd3c2.js
new file mode 100644
index 0000000..8d3abd6
--- /dev/null
+++ b/public/en.search.min.ed4281223476397821bb0f574a22254cb0af857a6c6f5f018e516b51695dd3c2.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.fe0941d300a2370fc90ac6edc4c194ea7c53bf16dc26d1a4463f8e32d18a9818.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.eebe38aea2e9eceb99d28da6711f23889abdfadfd2d78cc10939dd22a6a600a2.js b/public/en.search.min.eebe38aea2e9eceb99d28da6711f23889abdfadfd2d78cc10939dd22a6a600a2.js
new file mode 100644
index 0000000..98dd2c9
--- /dev/null
+++ b/public/en.search.min.eebe38aea2e9eceb99d28da6711f23889abdfadfd2d78cc10939dd22a6a600a2.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.65d015c500b7ca4aa2427d4f8051a29a701136efbc50403977ab87f648665f45.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.ef4488c076173b86dfff563b59eab35046f2c32fa2ba08243c8514a6eaa81971.js b/public/en.search.min.ef4488c076173b86dfff563b59eab35046f2c32fa2ba08243c8514a6eaa81971.js
new file mode 100644
index 0000000..2544c8a
--- /dev/null
+++ b/public/en.search.min.ef4488c076173b86dfff563b59eab35046f2c32fa2ba08243c8514a6eaa81971.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.cb92a71bf272108022864f9f81217f340a3281a7cd6c85c873b240b72e030c34.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f17a2a15ff389d4fdc309bce9c690659208cfbfebf8e126b0d47da5b75a3a51a.js b/public/en.search.min.f17a2a15ff389d4fdc309bce9c690659208cfbfebf8e126b0d47da5b75a3a51a.js
new file mode 100644
index 0000000..d91ff83
--- /dev/null
+++ b/public/en.search.min.f17a2a15ff389d4fdc309bce9c690659208cfbfebf8e126b0d47da5b75a3a51a.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.cd39fbec43262cbf79031d0910fc82273867662ce5240c50a65a93cba1c6850a.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f1f53372db5fc03c6b6f44fa692ec6f07e64e7ffe8cf110d0ef2534d34bf6588.js b/public/en.search.min.f1f53372db5fc03c6b6f44fa692ec6f07e64e7ffe8cf110d0ef2534d34bf6588.js
new file mode 100644
index 0000000..feb8817
--- /dev/null
+++ b/public/en.search.min.f1f53372db5fc03c6b6f44fa692ec6f07e64e7ffe8cf110d0ef2534d34bf6588.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.03f3c1ecf90ff6b881143e6b0097e69bd76e5c051cd3ee6e27416d40471231a4.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f3eea2569cbf5e2aa67f7cfd6de6cf16e6f7fe3bd02b10fe50336c55bd7d9fda.js b/public/en.search.min.f3eea2569cbf5e2aa67f7cfd6de6cf16e6f7fe3bd02b10fe50336c55bd7d9fda.js
new file mode 100644
index 0000000..76579e2
--- /dev/null
+++ b/public/en.search.min.f3eea2569cbf5e2aa67f7cfd6de6cf16e6f7fe3bd02b10fe50336c55bd7d9fda.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.9c75bba4a8ea5c57659bb7bef01fbb932f699ea27e97f71802fb46e2b7fc0b07.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f5465f54a0d6221a804f254eb4965c17c87da4f70fce2fc2d3cf1e18f79746d1.js b/public/en.search.min.f5465f54a0d6221a804f254eb4965c17c87da4f70fce2fc2d3cf1e18f79746d1.js
new file mode 100644
index 0000000..2ea3cf7
--- /dev/null
+++ b/public/en.search.min.f5465f54a0d6221a804f254eb4965c17c87da4f70fce2fc2d3cf1e18f79746d1.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.8c19a39b7953525530ca513578ac8304dfb364dca417ba356000e0c617c0eb2a.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f620aa03fcc371afd0dbc92f970778e35bdb78b63d6e33ef78f855421f02d488.js b/public/en.search.min.f620aa03fcc371afd0dbc92f970778e35bdb78b63d6e33ef78f855421f02d488.js
new file mode 100644
index 0000000..544f0de
--- /dev/null
+++ b/public/en.search.min.f620aa03fcc371afd0dbc92f970778e35bdb78b63d6e33ef78f855421f02d488.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.c2d89b39a47110b577bde5ec2da55d97a8e04cfc34b38e31dcda5c5bf08baed3.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f7411bf3499b1f63054e525228187a98b4c0fce65f494c509b9362b9b63cec41.js b/public/en.search.min.f7411bf3499b1f63054e525228187a98b4c0fce65f494c509b9362b9b63cec41.js
new file mode 100644
index 0000000..f109d1c
--- /dev/null
+++ b/public/en.search.min.f7411bf3499b1f63054e525228187a98b4c0fce65f494c509b9362b9b63cec41.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.48cb37053681cb6970cb4fa9938e19c1d9e9a0feed8ca5eaea4bfc8a798ab026.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f75b6a32a0c3c800434e9600384e985703714fc2cbb88b0735f74be242503441.js b/public/en.search.min.f75b6a32a0c3c800434e9600384e985703714fc2cbb88b0735f74be242503441.js
new file mode 100644
index 0000000..cad7fc7
--- /dev/null
+++ b/public/en.search.min.f75b6a32a0c3c800434e9600384e985703714fc2cbb88b0735f74be242503441.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.bbc9f13e84fb2a17ce054c9d6dda33f30d41b11a84c7dfd7479e58999931f39f.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.f8aa4609e39892a78bc3e544207a5859147f7696a6b284f39d0b6a495de75325.js b/public/en.search.min.f8aa4609e39892a78bc3e544207a5859147f7696a6b284f39d0b6a495de75325.js
new file mode 100644
index 0000000..67bc620
--- /dev/null
+++ b/public/en.search.min.f8aa4609e39892a78bc3e544207a5859147f7696a6b284f39d0b6a495de75325.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.6b6b2b9842106379ea9ce4b07549d219663514e6bd370d1fefb6cc4003665bfb.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.fe257477d333f8d11bfe167e9e67d3faf22765ee8a95d9505966667280c32d12.js b/public/en.search.min.fe257477d333f8d11bfe167e9e67d3faf22765ee8a95d9505966667280c32d12.js
new file mode 100644
index 0000000..69cbdf8
--- /dev/null
+++ b/public/en.search.min.fe257477d333f8d11bfe167e9e67d3faf22765ee8a95d9505966667280c32d12.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.1de78ec5fba7c2a50151baf821e0a5f18b7840891b83f26f6faae6426c099e46.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/en.search.min.fee1c1313db92862c01d1c31742437564a0901773bbe502e4e3a31d21b2a35ee.js b/public/en.search.min.fee1c1313db92862c01d1c31742437564a0901773bbe502e4e3a31d21b2a35ee.js
new file mode 100644
index 0000000..5c9b690
--- /dev/null
+++ b/public/en.search.min.fee1c1313db92862c01d1c31742437564a0901773bbe502e4e3a31d21b2a35ee.js
@@ -0,0 +1 @@
+"use strict";(function(){const o="/en.search-data.min.a2f9a6f5c36a7330722b76867f3413a4eefd34aa3bfa41259825737e2d5b9566.json",i=Object.assign({cache:!0},{doc:{id:"id",field:["title","content"],store:["title","href","section"]}}),e=document.querySelector("#book-search-input"),t=document.querySelector("#book-search-results");if(!e)return;e.addEventListener("focus",n),e.addEventListener("keyup",s),document.addEventListener("keypress",a);function a(t){if(t.target.value!==void 0)return;if(e===document.activeElement)return;const n=String.fromCharCode(t.charCode);if(!r(n))return;e.focus(),t.preventDefault()}function r(t){const n=e.getAttribute("data-hotkeys")||"";return n.indexOf(t)>=0}function n(){e.removeEventListener("focus",n),e.required=!0,fetch(o).then(e=>e.json()).then(e=>{window.bookSearchIndex=FlexSearch.create("balance",i),window.bookSearchIndex.add(e)}).then(()=>e.required=!1).then(s)}function s(){for(;t.firstChild;)t.removeChild(t.firstChild);if(!e.value)return;const n=window.bookSearchIndex.search(e.value,10);n.forEach(function(e){const n=c("<li><a href></a><small></small></li>"),s=n.querySelector("a"),o=n.querySelector("small");s.href=e.href,s.textContent=e.title,o.textContent=e.section,t.appendChild(n)})}function c(e){const t=document.createElement("div");return t.innerHTML=e,t.firstChild}})()
\ No newline at end of file
diff --git a/public/index.html b/public/index.html
index 2420a5e..e711ad1 100644
--- a/public/index.html
+++ b/public/index.html
@@ -17,9 +17,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <link rel="alternate" type="application/rss+xml" href="http://localhost:1313/index.xml" title="p5.fab" />
 <!--
 Made with Book Theme
@@ -104,41 +104,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -150,24 +116,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -176,7 +129,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -187,19 +140,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/public/index.xml b/public/index.xml
index 833b0a6..03056a3 100644
--- a/public/index.xml
+++ b/public/index.xml
@@ -8,13 +8,6 @@
     <language>en-us</language>
     <lastBuildDate>Mon, 01 Jan 0001 00:00:00 +0000</lastBuildDate>
     <atom:link href="http://localhost:1313/index.xml" rel="self" type="application/rss+xml" />
-    <item>
-      <title>A Gentle Introduction to Digital Fabrication</title>
-      <link>http://localhost:1313/docs/resources/guides/dfab-intro/</link>
-      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/resources/guides/dfab-intro/</guid>
-      <description>A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.</description>
-    </item>
     <item>
       <title>Quickstart</title>
       <link>http://localhost:1313/docs/quickstart/</link>
@@ -22,6 +15,20 @@
       <guid>http://localhost:1313/docs/quickstart/</guid>
       <description>p5.fab Quickstart # Here are a couple of ways to get started with p5.fab.&#xA;Online Editor # Using Chrome1, open the online editor. Design your artifact! You can start from one of the examples; try changing some of the values in the sketch to see what happens to the resulting object. Physically connect your computer to your fabrication machine2 with a USB cable and click &amp;lsquo;Connect&amp;rsquo;. Start making! Press &amp;lsquo;Print&amp;rsquo; to start streaming commands to your machine.</description>
     </item>
+    <item>
+      <title>Machine Compatibility</title>
+      <link>http://localhost:1313/docs/machine-compatibility/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/machine-compatibility/</guid>
+      <description>Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We&amp;rsquo;ve tested p5.fab on the following machines:&#xA;Machine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill).</description>
+    </item>
+    <item>
+      <title></title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setabsolutepositionxyz/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setabsolutepositionxyz/</guid>
+      <description>to come</description>
+    </item>
     <item>
       <title>A Gentle Introduction to Creative Coding with p5.js</title>
       <link>http://localhost:1313/docs/resources/guides/cc-intro/</link>
@@ -30,18 +37,18 @@
       <description>A Gentle Introduction to Creative Coding with p5.js # This page provides a brief introduction to some key concepts for creative coding with p5.js. It is by no means exhaustive, but provides helpful background information for newcomers to dicreative code. If you’re already familiar with computer-controlled machines but want to learn a bit about digital fabrication, check out the digital fabrication intro, or if you want to learn how to make things with p5.</description>
     </item>
     <item>
-      <title>Machine Compatibility</title>
-      <link>http://localhost:1313/docs/machine-compatibility/</link>
+      <title>A Gentle Introduction to Digital Fabrication</title>
+      <link>http://localhost:1313/docs/resources/guides/dfab-intro/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/machine-compatibility/</guid>
-      <description>Machine Compatibility # p5.fab is intended to be used with physical machines! In general, it should work with any machine running Marlin firmware. This is the firmware that many companies (e.g. Creality, Prusa, Ultimaker) use, as well as various custom/open-source machines. For more background on machine firmwares, check out the digital fabrication intro. We&amp;rsquo;ve tested p5.fab on the following machines:&#xA;Machine Info Creality Ender3 3D Printer Prusa i3-mk3 3D Printer FLSUN Q9 Delta 3D Printer Potterbot 9 Ceramic 3D Printer Jubilee Toolchanging Machine While most of these are 3D printers, we are working on extending control to Plotters (like the AxiDraw) and CNC machines (like the Othermill).</description>
+      <guid>http://localhost:1313/docs/resources/guides/dfab-intro/</guid>
+      <description>A Gentle Introduction to Digital Fabrication # This page provides a brief introduction to some key concepts in digital fabrication. It is by no means exhaustive, but provides helpful background information for newcomers to digital fabrication machines. If you’re already familiar with computer-controlled machines but want to learn a bit about creative coding, check out the creative coding intro, or if you want to learn how to make things with p5.</description>
     </item>
     <item>
-      <title>p5.fab Primer</title>
-      <link>http://localhost:1313/docs/resources/guides/p5fab-primer/</link>
+      <title>Autohome</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/autohome/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/resources/guides/p5fab-primer/</guid>
-      <description>p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.&#xA;Anatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go!</description>
+      <guid>http://localhost:1313/docs/reference/reference-pages/autohome/</guid>
+      <description>autoHome() Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command). Syntax # fab.autoHome() Parameters # None</description>
     </item>
     <item>
       <title>Cube Tutorial</title>
@@ -51,11 +58,11 @@
       <description>Printing a Cube # Stay tuned! For now, check out the cube example on the online editor.</description>
     </item>
     <item>
-      <title>Non-Planar Printing Tutorial</title>
-      <link>http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/</link>
+      <title>Fab</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/fab/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/</guid>
-      <description>Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.</description>
+      <guid>http://localhost:1313/docs/reference/reference-pages/fab/</guid>
+      <description> Fab # A class to describe a fabrication machine.&#xA;A fab object represents a 3D printer. It is comprised of the following information:&#xA;workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])&#xA;Parameters # config: a json object specifying requisite machine information </description>
     </item>
     <item>
       <title>Line Vase Tutorial</title>
@@ -65,11 +72,130 @@
       <description>Line Vase Tutorial # Stay tuned! For now, check out the line vase example on the online editor.</description>
     </item>
     <item>
-      <title></title>
-      <link>http://localhost:1313/docs/reference/</link>
+      <title>Move</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/move/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/move/</guid>
+      <description>move() Move relative to the current position without extruding material. Syntax # fab.move(dx, dy, dz, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) dy Number, the relative y distance to move (in current units, mm by default) dz Number, the relative z distance to move (in current units, mm by default) velocity v: Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move Extrude</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/moveextrude/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/moveextrude/</guid>
+      <description>moveExtrude() Move directly to an absolute (x,y,z) position while extruding material. Default extrusion amounts are calculated if not specified. Syntax # fab.moveExtrude(x, y, z, [velocity], [extrusion], [multiplication]) Parameters # x Number, the x position to move to (in current units, mm by default) y Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional.</description>
+    </item>
+    <item>
+      <title>Move To</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/moveto/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/moveto/</guid>
+      <description>moveTo() Move directly to an absolute (x,y,z) position without extruding material. Syntax # fab.moveTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move To E</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetoe/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetoe/</guid>
+      <description>moveToE() Move directly to an absolute E position. Syntax # fab.moveToE(e, [velocity]) Parameters # e e: Number, the e position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) - e: Number, the e position to move to (in current units, mm by default) - v: Number, optional, the speed to move at (in current units/sec, 25 mm/sec by default)</description>
+    </item>
+    <item>
+      <title>Move To X</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetox/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetox/</guid>
+      <description>moveToX() Move directly to an absolute X position without extruding material. Syntax # fab.moveToX(x, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move To X</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movex/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movex/</guid>
+      <description>moveX() Move in X relative to the current position without extruding material. Syntax # fab.moveX(dx, [velocity]) Parameters # dx Number, the relative x distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move To Y</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetoy/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetoy/</guid>
+      <description>moveToY() Move directly to an absolute Y position without extruding material. Syntax # fab.moveToY(y, [velocity]) Parameters # y Number, the y position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Move Y</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movey/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movey/</guid>
+      <description>moveY() Move in Y relative to the current position without extruding material. Syntax # fab.moveY(dy, [velocity]) Parameters # dy Number, the relative y distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>moveE</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movee/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movee/</guid>
+      <description>moveE() Move in E relative to the current position. Syntax # fab.moveE(de, [velocity]) Parameters # de Number, the relative e distance to move (in current units, mm by default) v Number, optional, the speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>MoveToZ</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movetoz/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movetoz/</guid>
+      <description>moveToZ() Move directly to an absolute Z position without extruding material. Syntax # fab.moveToZ(z, [velocity]) Parameters # z Number, the z position to move to (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>MoveZ</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/movez/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/movez/</guid>
+      <description>moveZ() Move in Z relative to the current position without extruding material. Syntax # fab.moveZ(dz, [velocity]) Parameters # dz Number, the relative z distance to move (in current units, mm by default) v v: Number, optional. The speed to move at (in current units/sec, inherited or 25 mm/sec by default) </description>
+    </item>
+    <item>
+      <title>Non-Planar Printing Tutorial</title>
+      <link>http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/</guid>
+      <description>Line Vase Tutorial # Stay tuned! For now, check out the non-planar vase example on the online editor.</description>
+    </item>
+    <item>
+      <title>p5.fab Primer</title>
+      <link>http://localhost:1313/docs/resources/guides/p5fab-primer/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/resources/guides/p5fab-primer/</guid>
+      <description>p5.fab Primer # This page provides an introduction to using p5.fab. If you’re new to digital fabrication and/or creative code and want some more context for the information presented here, check out the digital fabrication and creative coding introductions.&#xA;Anatomy of a p5.fab Sketch # p5.fab adds to the default setup() and draw() functions a fabDraw() function. fabDraw() is run once, immediately after setup and before the first draw loop, and is where any code which generates toolpath should go!</description>
+    </item>
+    <item>
+      <title>Set Absolute Position</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setabsoluteposition/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setabsoluteposition/</guid>
+      <description>setAbsolutePosition() Set coordinates to absolute positioning, relative to the origin of the machine (using a G90 command). Note that behaviour differs depending on firmware. For example, G90 on Marlin will set the extruder to absolute position as well, whereas Duet does not. To set absolute/relative position of dimensional and extruder positions seperately, see &amp;lt;ssetAbsolutePositionXYZ().&#xA;Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding.</description>
+    </item>
+    <item>
+      <title>Set Bed Temp</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setbedt/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setbedt/</guid>
+      <description>setBedT() Set the printer&#39;s bed temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&amp;rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.&#xA;Syntax # fab.setBedT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding.</description>
+    </item>
+    <item>
+      <title>Set Nozzle Temp</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/setnozzlet/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/setnozzlet/</guid>
+      <description>setNozzleT() Set the printer&#39;s nozzle temperature. By default, this command will wait for the nozzle temperature to reach the target temperature. Most firmware won&amp;rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.&#xA;Syntax # fab.setNozzleT(temperature, [wait]) Parameters # temperature Number, the temperature to heat the nozzle to in degrees Celcius wait Boolean, optional, parameter to wait for the target temperature to be reached before proceeding.</description>
+    </item>
+    <item>
+      <title>Set Temps</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/settemps/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/docs/reference/reference-pages/settemps/</guid>
+      <description>setTemps() Set the printer nozzle and bed temperature at the same time. By default, this command will wait for the temperatures to reach the target temperature. This command is faster than setting the nozzle and bed temperatures independently, as both will heat simultaneously. Most firmware won&amp;rsquo;t wait for temperatures less than 40C since they will never be reached due to ambient temperature.&#xA;Syntax # fab.setTemps(nozzleTemperature, bedTemperature, [wait]) Parameters # nozzleTemperature Number, the temperature to heat the nozzle to in degrees Celcius bedTemperature Number, the temperature to heat the bed to in degrees Celcius wait Boolean, optional parameter to wait for the target temperature to be reached before proceeding.</description>
+    </item>
+    <item>
+      <title>Travel To</title>
+      <link>http://localhost:1313/docs/reference/reference-pages/travelto/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      <guid>http://localhost:1313/docs/reference/</guid>
-      <description>Reference # Fab # A class to describe a fabrication machine.&#xA;A fab object represents a 3D printer. It is comprised of the following information:&#xA;workEnvelope: maximum X, Y, and Z dimensions of the machine nozzleDiameter: Diameter of the nozzle in mm filamentDiameter: Diameter of filament in mm name: a human readable string to identify this machine Syntax # fab([config])&#xA;Parameters # config: a json object specifying requisite machine information autoHome # Autohome the machine (with a G28 command) and zero the extruder position (with a G92 E0 command).</description>
+      <guid>http://localhost:1313/docs/reference/reference-pages/travelto/</guid>
+      <description>travelTo() Travel directly to an absolute (x,y,z) position with a z-hop (popping the nozzle away from the bed before moving, and restoring z position upon arrival), without extruding material. The hop distance is set in the current working units, and is 2mm by default. Edit this value in the printer configuration.&#xA;Syntax # fab.travelTo(x, y, z, [velocity]) Parameters # x Number, the x position to move to (in current units, mm by default) y y: Number, the y position to move to (in current units, mm by default) z Number, the z position to move to (in current units, mm by default) v v: Number, optional.</description>
     </item>
   </channel>
 </rss>
diff --git a/public/sitemap.xml b/public/sitemap.xml
index 3319c89..1cb1f26 100644
--- a/public/sitemap.xml
+++ b/public/sitemap.xml
@@ -2,33 +2,71 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
   xmlns:xhtml="http://www.w3.org/1999/xhtml">
   <url>
-    <loc>http://localhost:1313/docs/resources/guides/dfab-intro/</loc>
-  </url><url>
     <loc>http://localhost:1313/docs/quickstart/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/machine-compatibility/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/resources/</loc>
+  </url><url>
+    <loc>http://localhost:1313/</loc>
+    <lastmod>2024-03-04T15:58:36-08:00</lastmod>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/setabsolutepositionxyz/</loc>
   </url><url>
     <loc>http://localhost:1313/docs/resources/guides/cc-intro/</loc>
   </url><url>
-    <loc>http://localhost:1313/docs/machine-compatibility/</loc>
+    <loc>http://localhost:1313/docs/resources/guides/dfab-intro/</loc>
   </url><url>
-    <loc>http://localhost:1313/docs/resources/guides/p5fab-primer/</loc>
+    <loc>http://localhost:1313/docs/reference/reference-pages/autohome/</loc>
+  </url><url>
+    <loc>http://localhost:1313/categories/</loc>
   </url><url>
     <loc>http://localhost:1313/docs/resources/tutorials/cube-tutorial/</loc>
   </url><url>
-    <loc>http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/</loc>
+    <loc>http://localhost:1313/docs/</loc>
   </url><url>
-    <loc>http://localhost:1313/docs/resources/</loc>
+    <loc>http://localhost:1313/docs/reference/reference-pages/fab/</loc>
   </url><url>
     <loc>http://localhost:1313/docs/resources/tutorials/line-vase-tutorial/</loc>
   </url><url>
-    <loc>http://localhost:1313/</loc>
-    <lastmod>2024-03-04T15:58:36-08:00</lastmod>
+    <loc>http://localhost:1313/docs/reference/reference-pages/move/</loc>
   </url><url>
-    <loc>http://localhost:1313/docs/reference/</loc>
+    <loc>http://localhost:1313/docs/reference/reference-pages/moveextrude/</loc>
   </url><url>
-    <loc>http://localhost:1313/categories/</loc>
+    <loc>http://localhost:1313/docs/reference/reference-pages/moveto/</loc>
   </url><url>
-    <loc>http://localhost:1313/docs/</loc>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movetoe/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movetox/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movex/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movetoy/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movey/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movee/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movetoz/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/movez/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/resources/tutorials/non-planar-tutorial/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/resources/guides/p5fab-primer/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/setabsoluteposition/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/setbedt/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/setnozzlet/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/settemps/</loc>
   </url><url>
     <loc>http://localhost:1313/tags/</loc>
+  </url><url>
+    <loc>http://localhost:1313/docs/reference/reference-pages/travelto/</loc>
   </url>
 </urlset>
diff --git a/public/tags/index.html b/public/tags/index.html
index 1da9caa..43f49b1 100644
--- a/public/tags/index.html
+++ b/public/tags/index.html
@@ -15,9 +15,9 @@
 <link rel="manifest" href="/manifest.json">
 <link rel="icon" href="/favicon.png" >
 <link rel="canonical" href="http://localhost:1313/tags/">
-<link rel="stylesheet" href="/book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css" integrity="sha256-QH1p0KRTZMAXg4MFYEPf&#43;zTaayQj2QhhMTygSc6nN&#43;E=" crossorigin="anonymous">
+<link rel="stylesheet" href="/book.min.8dc49207f16fef5796dbc7e6df6f6047848472a80489f2e94157bb980517c289.css" integrity="sha256-jcSSB/Fv71eW28fm329gR4SEcqgEifLpQVe7mAUXwok=" crossorigin="anonymous">
   <script defer src="/flexsearch.min.js"></script>
-  <script defer src="/en.search.min.b726de4a7cd71eac112295f5b0dda153259418c24b72f8010adbac418098455f.js" integrity="sha256-tybeSnzXHqwRIpX1sN2hUyWUGMJLcvgBCtusQYCYRV8=" crossorigin="anonymous"></script>
+  <script defer src="/en.search.min.afa1bc2851cf7552fd4313bcad413b2d48fb4c16949eb4d630b93ef40b6eb625.js" integrity="sha256-r6G8KFHPdVL9QxO8rUE7LUj7TBaUnrTWMLk&#43;9AtutiU=" crossorigin="anonymous"></script>
 <link rel="alternate" type="application/rss+xml" href="http://localhost:1313/tags/index.xml" title="p5.fab" />
 <!--
 Made with Book Theme
@@ -102,41 +102,7 @@ <h2 class="book-brand">
           
   <ul>
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/dfab-intro/" class="">A Gentle Introduction to Digital Fabrication</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/cc-intro/" class="">A Gentle Introduction to Creative Coding with p5.js</a>
-  
-
-        </li>
-      
-    
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/resources/guides/p5fab-primer/" class="">p5.fab Primer</a>
-  
+  </ul>
 
         </li>
       
@@ -148,24 +114,11 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/cube-tutorial/" class="">Cube Tutorial</a>
+    <a href="/docs/reference/" class="">Reference</a>
   
 
-        </li>
-      
-    
-      
-        <li>
           
-  
-  
-
-  
-    <a href="/docs/resources/tutorials/non-planar-tutorial/" class="">Non-Planar Printing Tutorial</a>
-  
-
-        </li>
-      
+  <ul>
     
       
         <li>
@@ -174,7 +127,7 @@ <h2 class="book-brand">
   
 
   
-    <a href="/docs/resources/tutorials/line-vase-tutorial/" class="">Line Vase Tutorial</a>
+    <a href="/docs/reference/reference-pages/setabsolutepositionxyz/" class="">Set Absolute Position Xyz</a>
   
 
         </li>
@@ -185,19 +138,6 @@ <h2 class="book-brand">
         </li>
       
     
-      
-        <li>
-          
-  
-  
-
-  
-    <a href="/docs/reference/" class="">Reference</a>
-  
-
-        </li>
-      
-    
   </ul>
 
 
diff --git a/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.content b/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.content
index b10261b..74e7f6b 100644
--- a/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.content
+++ b/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.content
@@ -1 +1 @@
-@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,sans-serif}
\ No newline at end of file
+@charset "UTF-8";:root{--gray-100:#f8f9fa;--gray-200:#e9ecef;--gray-500:#adb5bd;--color-link:#0055bb;--color-visited-link:#8440f1;--body-background:white;--body-font-color:black;--icon-filter:none;--hint-color-info:#6bf;--hint-color-warning:#fd6;--hint-color-danger:#f66}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.flex{display:flex}.flex-auto{flex:auto}.flex-even{flex:1 1}.flex-wrap{flex-wrap:wrap}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.align-center{align-items:center}.mx-auto{margin:0 auto}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.hidden{display:none}input.toggle{height:0;width:0;overflow:hidden;opacity:0;position:absolute}.clearfix::after{content:"";display:table;clear:both}html{font-size:16px;scroll-behavior:smooth;touch-action:manipulation}body{min-width:20rem;color:var(--body-font-color);background:var(--body-background);letter-spacing:.33px;font-weight:400;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;box-sizing:border-box}body *{box-sizing:inherit}h1,h2,h3,h4,h5{font-weight:400}a{text-decoration:none;color:var(--color-link)}img{vertical-align:baseline}:focus{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}aside nav ul{padding:0;margin:0;list-style:none}aside nav ul li{margin:1em 0;position:relative}aside nav ul a{display:block}aside nav ul a:hover{opacity:.5}aside nav ul ul{padding-inline-start:1rem}ul.pagination{display:flex;justify-content:center;list-style-type:none;padding-inline-start:0}ul.pagination .page-item a{padding:1rem}.container{max-width:80rem;margin:0 auto}.book-icon{filter:var(--icon-filter)}.book-brand{margin-top:0;margin-bottom:1rem}.book-brand img{height:1.5em;width:1.5em;margin-inline-end:.5rem}.book-menu{flex:0 0 16rem;font-size:.875rem}.book-menu .book-menu-content{width:16rem;padding:1rem;background:var(--body-background);position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-menu a,.book-menu label{color:inherit;cursor:pointer;word-wrap:break-word}.book-menu a.active{color:var(--color-link)}.book-menu input.toggle+label+ul{display:none}.book-menu input.toggle:checked+label+ul{display:block}.book-menu input.toggle+label::after{content:"▸"}.book-menu input.toggle:checked+label::after{content:"▾"}body[dir=rtl] .book-menu input.toggle+label::after{content:"◂"}body[dir=rtl] .book-menu input.toggle:checked+label::after{content:"▾"}.book-section-flat{margin:2rem 0}.book-section-flat>a,.book-section-flat>span,.book-section-flat>label{font-weight:bolder}.book-section-flat>ul{padding-inline-start:0}.book-page{min-width:20rem;flex-grow:1;padding:1rem}.book-post{margin-bottom:3rem}.book-header{display:none;margin-bottom:1rem}.book-header label{line-height:0}.book-header img.book-icon{height:1.5em;width:1.5em}.book-search{position:relative;margin:1rem 0;border-bottom:1px solid transparent}.book-search input{width:100%;padding:.5rem;border:0;border-radius:.25rem;background:var(--gray-100);color:var(--body-font-color)}.book-search input:required+.book-search-spinner{display:block}.book-search .book-search-spinner{position:absolute;top:0;margin:.5rem;margin-inline-start:calc(100% - 1.5rem);width:1rem;height:1rem;border:1px solid transparent;border-top-color:var(--body-font-color);border-radius:50%;animation:spin 1s ease infinite}@keyframes spin{100%{transform:rotate(360deg)}}.book-search small{opacity:.5}.book-toc{flex:0 0 16rem;font-size:.75rem}.book-toc .book-toc-content{width:16rem;padding:1rem;position:fixed;top:0;bottom:0;overflow-x:hidden;overflow-y:auto}.book-toc img{height:1em;width:1em}.book-toc nav>ul>li:first-child{margin-top:0}.book-footer{padding-top:1rem;font-size:.875rem}.book-footer img{height:1em;width:1em;margin-inline-end:.5rem}.book-comments{margin-top:1rem}.book-languages{margin-block-end:2rem}.book-languages .book-icon{height:1em;width:1em;margin-inline-end:.5em}.book-languages ul{padding-inline-start:1.5em}.book-menu-content,.book-toc-content,.book-page,.book-header aside,.markdown{transition:.2s ease-in-out;transition-property:transform,margin,opacity,visibility;will-change:transform,margin,opacity}@media screen and (max-width:56rem){#menu-control,#toc-control{display:inline}.book-menu{visibility:hidden;margin-inline-start:-16rem;font-size:16px;z-index:1}.book-toc{display:none}.book-header{display:block}#menu-control:focus~main label[for=menu-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#menu-control:checked~main .book-menu{visibility:initial}#menu-control:checked~main .book-menu .book-menu-content{transform:translateX(16rem);box-shadow:0 0 .5rem rgba(0,0,0,.1)}#menu-control:checked~main .book-page{opacity:.25}#menu-control:checked~main .book-menu-overlay{display:block;position:absolute;top:0;bottom:0;left:0;right:0}#toc-control:focus~main label[for=toc-control]{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}#toc-control:checked~main .book-header aside{display:block}body[dir=rtl] #menu-control:checked~main .book-menu .book-menu-content{transform:translateX(-16rem)}}@media screen and (min-width:80rem){.book-page,.book-menu .book-menu-content,.book-toc .book-toc-content{padding:2rem 1rem}}@font-face{font-family:roboto;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-regular.woff2)format("woff2"),url(fonts/roboto-v27-latin-regular.woff)format("woff")}@font-face{font-family:roboto;font-style:normal;font-weight:700;font-display:swap;src:local(""),url(fonts/roboto-v27-latin-700.woff2)format("woff2"),url(fonts/roboto-v27-latin-700.woff)format("woff")}@font-face{font-family:roboto mono;font-style:normal;font-weight:400;font-display:swap;src:local(""),url(fonts/roboto-mono-v13-latin-regular.woff2)format("woff2"),url(fonts/roboto-mono-v13-latin-regular.woff)format("woff")}body{font-family:roboto,sans-serif}code{font-family:roboto mono,monospace}@media print{.book-menu,.book-footer,.book-toc{display:none}.book-header,.book-header aside{display:block}main{display:block!important}}.markdown{line-height:1.6}.markdown>:first-child{margin-top:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown h5,.markdown h6{font-weight:400;line-height:1;margin-top:1.5em;margin-bottom:1rem}.markdown h1 a.anchor,.markdown h2 a.anchor,.markdown h3 a.anchor,.markdown h4 a.anchor,.markdown h5 a.anchor,.markdown h6 a.anchor{opacity:0;font-size:.75em;vertical-align:middle;text-decoration:none}.markdown h1:hover a.anchor,.markdown h1 a.anchor:focus,.markdown h2:hover a.anchor,.markdown h2 a.anchor:focus,.markdown h3:hover a.anchor,.markdown h3 a.anchor:focus,.markdown h4:hover a.anchor,.markdown h4 a.anchor:focus,.markdown h5:hover a.anchor,.markdown h5 a.anchor:focus,.markdown h6:hover a.anchor,.markdown h6 a.anchor:focus{opacity:initial}.markdown h4,.markdown h5,.markdown h6{font-weight:bolder}.markdown h5{font-size:.875em}.markdown h6{font-size:.75em}.markdown b,.markdown optgroup,.markdown strong{font-weight:bolder}.markdown a{text-decoration:none}.markdown a:hover{text-decoration:underline}.markdown a:visited{color:var(--color-visited-link)}.markdown img{max-width:100%;height:auto}.markdown code{padding:0 .25rem;background:var(--gray-200);border-radius:.25rem;font-size:.875em}.markdown pre{padding:1rem;background:var(--gray-100);border-radius:.25rem;overflow-x:auto}.markdown pre code{padding:0;background:0 0}.markdown p{word-wrap:break-word}.markdown blockquote{margin:1rem 0;padding:.5rem 1rem .5rem .75rem;border-inline-start:.25rem solid var(--gray-200);border-radius:.25rem}.markdown blockquote :first-child{margin-top:0}.markdown blockquote :last-child{margin-bottom:0}.markdown table{overflow:auto;display:block;border-spacing:0;border-collapse:collapse;margin-top:1rem;margin-bottom:1rem}.markdown table tr th,.markdown table tr td{padding:.5rem 1rem;border:1px solid var(--gray-200)}.markdown table tr:nth-child(2n){background:var(--gray-100)}.markdown hr{height:1px;border:none;background:var(--gray-200)}.markdown ul,.markdown ol{padding-inline-start:2rem;word-wrap:break-word}.markdown dl dt{font-weight:bolder;margin-top:1rem}.markdown dl dd{margin-inline-start:0;margin-bottom:1rem}.markdown .highlight table tr td:nth-child(1) pre{margin:0;padding-inline-end:0}.markdown .highlight table tr td:nth-child(2) pre{margin:0;padding-inline-start:0}.markdown details{padding:1rem;border:1px solid var(--gray-200);border-radius:.25rem}.markdown details summary{line-height:1;padding:1rem;margin:-1rem;cursor:pointer}.markdown details[open] summary{margin-bottom:0}.markdown figure{margin:1rem 0}.markdown figure figcaption p{margin-top:0}.markdown-inner>:first-child{margin-top:0}.markdown-inner>:last-child{margin-bottom:0}.markdown .book-expand{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden}.markdown .book-expand .book-expand-head{background:var(--gray-100);padding:.5rem 1rem;cursor:pointer}.markdown .book-expand .book-expand-content{display:none;padding:1rem}.markdown .book-expand input[type=checkbox]:checked+.book-expand-content{display:block}.markdown .book-tabs{margin-top:1rem;margin-bottom:1rem;border:1px solid var(--gray-200);border-radius:.25rem;overflow:hidden;display:flex;flex-wrap:wrap}.markdown .book-tabs label{display:inline-block;padding:.5rem 1rem;border-bottom:1px transparent;cursor:pointer}.markdown .book-tabs .book-tabs-content{order:999;width:100%;border-top:1px solid var(--gray-100);padding:1rem;display:none}.markdown .book-tabs input[type=radio]:checked+label{border-bottom:1px solid var(--color-link)}.markdown .book-tabs input[type=radio]:checked+label+.book-tabs-content{display:block}.markdown .book-tabs input[type=radio]:focus+label{outline-style:auto;outline-color:currentColor;outline-color:-webkit-focus-ring-color}.markdown .book-columns{margin-left:-1rem;margin-right:-1rem}.markdown .book-columns>div{margin:1rem 0;min-width:10rem;padding:0 1rem}.markdown a.book-btn{display:inline-block;font-size:.875rem;color:var(--color-link);line-height:2rem;padding:0 1rem;border:1px solid var(--color-link);border-radius:.25rem;cursor:pointer}.markdown a.book-btn:hover{text-decoration:none}.markdown .book-hint.info{border-color:#6bf;background-color:rgba(102,187,255,.1)}.markdown .book-hint.warning{border-color:#fd6;background-color:rgba(255,221,102,.1)}.markdown .book-hint.danger{border-color:#f66;background-color:rgba(255,102,102,.1)}@font-face{font-family:inter;src:url(fonts/Inter-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-Italic.ttf)format("truetype");font-weight:400;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Bold.ttf)format("truetype");font-weight:700;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-BoldItalic.ttf)format("truetype");font-weight:700;font-style:italic}@font-face{font-family:inter;src:url(fonts/Inter-Light.ttf)format("truetype");font-weight:lighter;font-style:normal}@font-face{font-family:inter;src:url(fonts/Inter-LightItalic.ttf)format("truetype");font-weight:lighter;font-style:italic}@font-face{font-family:spacegrotesk;src:url(fonts/SpaceGrotesk-Regular.ttf)format("truetype");font-weight:400;font-style:normal}@font-face{font-family:ibmplexmono;src:url(fonts/IBMPlexMono-Regular.ttf)format("truetype");font-weight:400;font-style:normal}body{font-family:inter,sans-serif}h2,h3{text-decoration:underline;text-decoration-color:#ff6700;text-decoration-thickness:3px}.fab{font-family:ibmplexmono,monospace}.ref-header{font-family:ibmplexmono,monospace;color:#000;font-size:2em;text-decoration:none}.ref-item{font-family:ibmplexmono,monospace;color:#000;font-size:1em}.ref-info{font-family:inter,sans-serif;color:#000;font-size:.9em}.markdown a{color:#000}.markdown a:visited{color:#000}.markdown a:hover{background-color:#ff6700}td{width:30%;vertical-align:top}.markdown table tr td{padding:1rem 4rem 4rem 0;border:none}.markdown table tr:nth-child(2n){background:#fff}.grid-container{display:grid;grid-template-columns:20% 80%;gap:.75rem 0}.grid-item{height:auto}
\ No newline at end of file
diff --git a/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.json b/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.json
index c63a70e..638b7e4 100644
--- a/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.json
+++ b/resources/_gen/assets/book.scss_e129fe35b8d0a70789c8a08429469073.json
@@ -1 +1 @@
-{"Target":"book.min.407d69d0a45364c0178383056043dffb34da6b2423d90861313ca049cea737e1.css","MediaType":"text/css","Data":{"Integrity":"sha256-QH1p0KRTZMAXg4MFYEPf+zTaayQj2QhhMTygSc6nN+E="}}
\ No newline at end of file
+{"Target":"book.min.424ed8219f008b963e0cffe62801bf2d6d26c7ff0080976d6d58c5a54a6b5f3f.css","MediaType":"text/css","Data":{"Integrity":"sha256-Qk7YIZ8Ai5Y+DP/mKAG/LW0mx/8AgJdtbVjFpUprXz8="}}
\ No newline at end of file