Images Directory
This directory contains all image assets for the website.
π Directory Structure
assets/images/
βββ README.md # This file
βββ favicon.ico # Site favicon
βββ profile-placeholder.jpg # Profile photo placeholder
βββ placeholder-1.jpg # Homepage featured image 1
βββ placeholder-2.jpg # Homepage featured image 2
βββ placeholder-3.jpg # Homepage featured image 3
βββ photography-category.jpg # Photography category image
βββ projects-category.jpg # Projects category image
βββ artwork-category.jpg # Artwork category image
βββ featured-1.jpg # Portfolio featured image 1
βββ featured-2.jpg # Portfolio featured image 2
βββ featured-3.jpg # Portfolio featured image 3
βββ featured-4.jpg # Portfolio featured image 4
πΌοΈ Image Guidelines
Recommended Specifications
- Format: JPEG for photos, PNG for graphics with transparency
- Quality: High quality, professional images
- Dimensions:
- Hero images: 1200x600px
- Featured images: 800x600px
- Category images: 600x400px
- Profile photo: 400x400px
- File Size: Optimize for web (max 500KB for large images)
- Aspect Ratio: Maintain consistent ratios within categories
Naming Convention
- Use descriptive, lowercase names
- Separate words with hyphens
- Include category or purpose in filename
- Example:
landscape-sunrise-mountains.jpg
Optimization Tips
- Compress images using tools like TinyPNG or ImageOptim
- Use appropriate formats:
- JPEG for photographs
- PNG for graphics with transparency
- WebP for modern browsers (with fallbacks)
- Consider responsive images with multiple sizes
- Add descriptive alt text for accessibility
πΈ Adding New Images
- Optimize your image for web use
- Place in appropriate subdirectory if organizing by category
- Update references in HTML/Markdown files
- Test on different screen sizes
π Image Usage Examples
In HTML
<img src="/assets/images/your-image.jpg" alt="Descriptive alt text" class="lazy" data-src="/assets/images/your-image.jpg">
In Markdown

With Lazy Loading
<img src="/assets/images/placeholder.jpg" alt="Alt text" class="lazy" data-src="/assets/images/actual-image.jpg">
π« Important Notes
- Donβt commit large image files (>1MB) to version control
- Use placeholder images during development
- Optimize before uploading to improve site performance
- Maintain backup copies of original high-resolution images
π οΈ Tools for Image Optimization
- Online: TinyPNG, Compressor.io, Squoosh.app
- Desktop: ImageOptim (Mac), FileOptimizer (Windows)
- Command Line: ImageMagick, jpegoptim, optipng
π± Responsive Images
Consider providing multiple image sizes for different screen resolutions:
<picture>
<source media="(min-width: 1200px)" srcset="/assets/images/large.jpg">
<source media="(min-width: 768px)" srcset="/assets/images/medium.jpg">
<img src="/assets/images/small.jpg" alt="Alt text">
</picture>
Remember: High-quality, optimized images are crucial for a professional portfolio website!