Update examples - add example of custom locations

Author: dannyadair

README.md

@@ -59,10 +59,18 @@ kept if you specify `--debug`.
 
 ## Examples
 
-For working examples, see the [examples](examples) directory.<br> Create all PDFs with:
+For working examples, see the [examples](examples) directory:
+
+- [minimal](examples/minimal) - Basic usage
+- [regular](examples/regular) - Standard features
+- [variants](examples/variants) - Document variants
+- [custom_locations](examples/custom_locations) - Custom file/directory locations
+- [custom_processing](examples/custom_processing) - Custom processing with Python
+
+Create all PDFs with:
 
 ```bash
-pdfbaker bake examples/examples.yml
+pdfbaker bake examples/examples.yaml
 ```
 
 ## Documentation

examples/custom_locations/other_pages/custom_page.yaml

@@ -0,0 +1,3 @@
+title: "Custom Location Example"
+description: "This page uses custom directory structure"
+template: "../other_templates/custom_page.svg.j2" 

examples/custom_locations/other_templates/custom_page.svg.j2

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg width="210mm" height="297mm" viewBox="0 0 210 297" version="1.1">
+  <text x="105" y="50" text-anchor="middle" font-size="20">{{ title }}</text>
+  <text x="105" y="80" text-anchor="middle" font-size="14">{{ description }}</text>
+</svg> 

examples/custom_locations/your_directory/config.yaml

@@ -0,0 +1,9 @@
+title: "Custom Locations Example"
+filename: "custom_locations_custom"
+pages:
+  # Simple notation - uses conventional location (pages/standard_page.yaml)
+  - "standard_page"
+  # Path notation - uses custom location
+  - "../other_pages/custom_page.yaml"
+# Custom images directory name and location
+images_dir: "../your_images" 

examples/custom_locations/your_directory/pages/content.yaml

@@ -0,0 +1,2 @@
+title: "Content Page"
+description: "This document is located in a nested directory structure, demonstrating how pdfbaker can handle documents located anywhere in your filesystem." 

examples/custom_locations/your_directory/pages/intro.yaml

@@ -0,0 +1,4 @@
+title: "Custom Locations Example"
+subtitle: "Mixing conventional and custom locations"
+template: "templates/intro.svg.j2"
+# Uses conventional location (templates/intro.svg.j2) 

examples/custom_locations/your_directory/pages/standard_page.yaml

@@ -0,0 +1,3 @@
+title: "Standard Location Example"
+subtitle: "This page uses conventional directory structure"
+template: "standard_page.svg.j2" 

examples/custom_locations/your_directory/templates/standard_page.svg.j2

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg width="210mm" height="297mm" viewBox="0 0 210 297" version="1.1">
+  <text x="105" y="50" text-anchor="middle" font-size="20">{{ title }}</text>
+  <text x="105" y="80" text-anchor="middle" font-size="14">{{ subtitle }}</text>
+</svg> 

examples/custom_locations/your_directory/your_images/pythonnz.png

@@ -6,7 +6,7 @@
 from datetime import datetime
 
 from pdfbaker.document import PDFBakerDocument
-from pdfbaker.errors import PDFBakeError
+from pdfbaker.errors import PDFBakerError
 
 
 def process_document(document: PDFBakerDocument) -> None:
@@ -30,8 +30,7 @@ def process_document(document: PDFBakerDocument) -> None:
             "fetched_at": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
             "image_data": image_data,
         }
-
-        # Process as usual
-        return document.process()
     except Exception as exc:
-        raise PDFBakeError(f"Failed to process XKCD example: {exc}") from exc
+        raise PDFBakerError(f"Failed to process XKCD example: {exc}") from exc
+
+    return document.process()