diff --git a/README.md b/README.md index a10ffaf..a365794 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,11 @@ # voronstl -Voron Project STL creating customer manifests where parts are easily discernible. \ No newline at end of file +Voron Project STL creating customer manifests where parts are easily discernible. + +# Directories +You will have three directory trees: +1) Voron Directory - this is a directory you create and then perform "git clone..." for each of the Voron projects you need STL files from. The files of interest in the tree are the STL files (warning: not all STL files have lowercase .stl suffixes). This is a read-only (git updatable) directory and the STL files there are the source of truth. +2) Staging Area - this is a directory you create where the links to the STL files within Voron Root Directory. The links are created under an identical tree structure. The Staging area also will also hold the *.glb files that are created from the STLs using Blender. This area will also hold the final HTML and its PNGs copied from the Project Code Area's pngs folder. +3) Project Code Area - this project's git clone directory. Note: there are two working directories were interim links to glbs and files, generated PNG images, are stored: + A) ...web/batch_glb_png/glbs - this is where links to the glb files (originals in the Staging Area) are staged + B) ...web/batch_glb_png/pngs - these are the PNG files created from the glbs [links] \ No newline at end of file diff --git a/exercises/create_glb_links/README.md b/exercises/create_glb_links/README.md new file mode 100644 index 0000000..bae80e2 --- /dev/null +++ b/exercises/create_glb_links/README.md @@ -0,0 +1,30 @@ +# Goal +Place soft links to the glb files created by Blender in the staging tree in a single directory, ```web/batch_glb_png/glbs,``` , so the glb->PNG converter can easily process a set of files in one directory and not have to navigate the staging tree. + +# Introduction +This is a simple run-a-script exercise. (Note: the name of the link has the complete directory path as part of the link name rather than a 1:1 match of the file name it links to.) + +# Steps +In a command console: + + cd ...web/batch_glb_png + date; time ./link_glbs.sh [PATH to the root directory of your GitHub staging area] + +Example: + + jlpoole@jp ~/work/Voron/voronstl/web/batch_glb_png $ date; time ./link_glbs.sh /home/jlpoole/work/Voron/test1 + Wed Mar 4 18:51:15 PST 2026 + ROOT: /home/jlpoole/work/Voron/test1 + OUTDIR: /home/jlpoole/work/Voron/voronstl/web/batch_glb_png/glbs + LOG: link_glbs_20260304_185115.log + + + DONE. linked=131 skipped=0 + 0 (details in link_glbs_20260304_185115.log) + + real 0m0.507s + user 0m0.569s + sys 0m0.263s + jlpoole@jp ~/work/Voron/voronstl/web/batch_glb_png $ ls -la glbs/ |wc -l + 136 + jlpoole@jp ~/work/Voron/voronstl/web/batch_glb_png $ \ No newline at end of file