fix: Restore working documentation pictures system

- Update Makefile doc target to copy media files from build/example/ to build/doc/example/
- Fix image paths in generate_example_docs.f90 to use example/ prefix instead of ../
- Add -fPIC flag to all FPM commands to fix C compilation linking issues
- Ensures FORD documentation has accessible images and PDFs

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: krystophny

Makefile

@@ -1,26 +1,29 @@
 # Allow additional arguments to be passed
 ARGS ?=
 
+# FPM flags for C compilation compatibility
+FPM_FLAGS = --flag -fPIC
+
 .PHONY: all build example debug test clean help matplotlib example_python example_matplotlib doc coverage create_build_dirs
 
 # Default target
 all: build
 
 # Build the project
 build:
-	fpm build $(ARGS)
+	fpm build $(FPM_FLAGS) $(ARGS)
 
 # Build and run the examples
 example: create_build_dirs
-	fpm run --example $(ARGS)
+	fpm run --example $(FPM_FLAGS) $(ARGS)
 
 # Build and run the apps for debugging
 debug:
-	fpm run $(ARGS)
+	fpm run $(FPM_FLAGS) $(ARGS)
 
 # Run tests
 test:
-	fpm test $(ARGS)
+	fpm test $(FPM_FLAGS) $(ARGS)
 
 # Run Python examples with fortplotlib (default mode)
 example_python:
@@ -66,6 +69,9 @@ run-release:
 # Build documentation with FORD
 doc:
 	ford doc.md
+	# Copy example media files to doc build directory for proper linking
+	mkdir -p build/doc/example
+	if [ -d build/example ]; then cp -r build/example/* build/doc/example/ 2>/dev/null || true; fi
 
 # Generate coverage report
 coverage:

example/generate_example_docs.f90

@@ -276,15 +276,15 @@ subroutine write_generated_outputs(unit_out, example_dir, example_name)
             if (extension == 'mp4') then
                 ! Embed video using HTML
                 write(unit_out, '(A)') '<video width="800" height="600" controls>'
-                write(unit_out, '(A)') '  <source src="../' // trim(example_name) // '/' // &
+                write(unit_out, '(A)') '  <source src="example/' // trim(example_name) // '/' // &
                                        trim(media_files(j)) // '" type="video/mp4">'
                 write(unit_out, '(A)') '  Your browser does not support the video tag.'
                 write(unit_out, '(A)') '</video>'
                 write(unit_out, '(A)') ''
-                write(unit_out, '(A)') '[Download MP4](../' // trim(example_name) // '/' // trim(media_files(j)) // ')'
+                write(unit_out, '(A)') '[Download MP4](example/' // trim(example_name) // '/' // trim(media_files(j)) // ')'
             else
                 ! Regular image
-                write(unit_out, '(A)') '![' // trim(media_files(j)) // '](../' // &
+                write(unit_out, '(A)') '![' // trim(media_files(j)) // '](example/' // &
                                        trim(example_name) // '/' // trim(media_files(j)) // ')'
                 write(unit_out, '(A)') ''
 
@@ -310,7 +310,7 @@ subroutine write_generated_outputs(unit_out, example_dir, example_name)
                 end if
 
                 ! Add PDF link
-                write(unit_out, '(A)') '[Download PDF](../' // trim(example_name) // '/' // &
+                write(unit_out, '(A)') '[Download PDF](example/' // trim(example_name) // '/' // &
                     trim(replace_extension(media_files(j), 'pdf')) // ')'
             end if
             write(unit_out, '(A)') ''
@@ -338,7 +338,7 @@ subroutine process_image_path(line, example_name)
                     filename = filename(index(filename, '/', back=.true.)+1:)
                 end if
                 ! Replace with relative path to example directory
-                new_path = '../' // trim(example_name) // '/' // trim(filename)
+                new_path = 'example/' // trim(example_name) // '/' // trim(filename)
                 line = line(1:start_pos+1) // trim(new_path) // ')'
             end if
         end if