Sparrow Fabrications — Project Guidance

Version Control

Never commit or push changes without explicitly asking the user first.

Adding a New Product

1. Find the right template

Products are flat .md files in the project root. Find an existing product for the same camera type and product type (e.g. shutter release cable adapter, filter adapter, lens cap) and duplicate it. Good sources to duplicate:

• Shutter release cable adapter: holga-120-v2-adapter.md
• Filter adapter: holga-filter.md
• Lens cap: holga-120-lens-cap.md

2. Create the product file

Name the file after the product slug, e.g. holga-digital-adapter.md. Front matter fields:

---
title: "Full descriptive title with camera name | 3D Printed UK"
description: "SEO meta description, ~120 characters."
rating_count: 4   # optional — only add once there are real reviews
---

Substitute the camera model name throughout the body copy. The structure follows this pattern:

1. Intro paragraph — what it is, what’s shown but not included, link to cable if applicable
2. ### Directions for use — numbered steps
3. ### Supported Cameras — tested and compatible models
4. ### Installation Video — embed from Etsy static hosting (optional, only if video exists)
5. ### Product Images — gallery include (see below)
6. ### Reviews — blockquote format (optional, only once reviews exist)
7. ### Also available for [camera] — links to sibling products

3. Images

Place full-resolution images in:

images/[product-slug]/

Place thumbnails in:

images/[product-slug]/thumbs/

Thumbnail spec: resize so the longest axis is ≤ 650px (preserving aspect ratio), then place on a 700×700 white canvas, centred. Save as JPEG quality 85.

Generate thumbnails with Python/Pillow (ImageMagick may not be available):

from PIL import Image
import os

src_dir = "images/[product-slug]"
thumb_dir = os.path.join(src_dir, "thumbs")
os.makedirs(thumb_dir, exist_ok=True)

for fname in os.listdir(src_dir):
    if not fname.endswith(".jpg"):
        continue
    img = Image.open(os.path.join(src_dir, fname)).convert("RGB")
    img.thumbnail((650, 650), Image.LANCZOS)
    canvas = Image.new("RGB", (700, 700), (255, 255, 255))
    canvas.paste(img, ((700 - img.width) // 2, (700 - img.height) // 2))
    canvas.save(os.path.join(thumb_dir, fname), "JPEG", quality=85)

Accessory images (e.g. shutter-release-cable.jpg) are included in the gallery to show items pictured but not included with the product. Copy the shared image into the product’s image directory and reference it at the end of the filenames list.

4. Gallery include syntax

<div class ="image-gallery">

    <div class="box">
    <a href="images/[product-slug]/image-1.jpg">
      <img src="images/[product-slug]/thumbs/image-1.jpg " alt="Descriptive alt text"  class="img-gallery" />
     </a>
    </div>
 
    <div class="box">
    <a href="images/[product-slug]/image-2.jpg">
      <img src="images/[product-slug]/thumbs/image-2.jpg " alt="Descriptive alt text"  class="img-gallery" />
     </a>
    </div>
 
    <div class="box">
    <a href="images/[product-slug]/shutter-release-cable.jpg">
      <img src="images/[product-slug]/thumbs/shutter-release-cable.jpg " alt="Descriptive alt text"  class="img-gallery" />
     </a>
    </div>
 
</div>

5. Update products.md

Add a link in the appropriate named section. Sections are grouped by camera brand with nested sub-sections per model. Insert alphabetically by camera name. Example:

### Holga Digital Cameras
- [Shutter Release Cable Adapter](/holga-digital-adapter.html)

If the camera brand already has a section, add the new product as a nested sub-section within it — not as a new top-level section. For example, Holga Digital sits under ### Holga Cameras as - Holga Digital Cameras with indented links beneath it.

6. Cross-reference all sibling products

Every product page must have an ### Also available for the [Camera Model] section at the bottom listing every other product for that camera. When adding a new product:

• Add the new product’s page with links to all existing sibling products
• Update every existing sibling product page to add a link back to the new product

If a camera model only has one product, no “Also available” section is needed.