README.md

Photography

A jekyll website for photographers

Highlights

1. Easy setup and you get a website of your own for free. No web hosting charges too.
2. To add new pictures, you need to just upload them. No code changes required.
3. And, my favorite, you get to see EXIF data like aperture, shutter speed, iso etc. when you click on any image, automagically. Moreover, you can customize this as per your needs.

Quick Start

If you know a tad about tech and love taking pictures then this open-source project may help you setup a website to showcase all your creations without effort. And not just that, with this you need not pay a single dime to host your website as it's hosted by GitHub for free.

Just follow the below steps and your website would be live in no time:

1. Fork this repo by hitting the Fork button at the top right corner.
2. Enable github pages from the repo settings.
3. Upload your pictures to images/fulls and images/thumbs directory. You can do that on github.com itself or you can clone and push the images to your repo.
4. Add your own custom domain in CNAME file or just remove the file if you don't own a domain and use the default domain that github provides ([yourusername].github.io/photography).
5. Update baseurl field in _config.yml file with whatever domain you used in step 4.
6. And that's it, your website is set. To view, go to photography.rampatra.com (or whatever you have in the CNAME file) and if you don't have one, you can go to [yourusername].github.io/photography

And, of course, you don't want my name at the bottom to show up. You can change it in _config.yml file as well as a few other settings like your social links, google analytics, etc. Just do not forget to build the website after you make the changes.

Run the website on docker

1. $ cd photography - go to the project directory
2. $ docker build -t photography . - build the docker image
3. run the container:

   docker run -d \
     -p 4000:4000 \
     -v "/path/to/images/:/app/images/fulls/" \
     --name photography \
     photography

Run the website locally to test

1. $ cd photography - go to the project directory
2. $ bundle install - install gems
3. Change the baseurl in _config.yml
4. $ bundle exec jekyll serve - start/run the website

Build the website

1. $ cd photography - go to the project directory
2. $ npm install - install all npm dependencies
3. $ gulp - minify css, js, resize images, etc.

Note: You only need to build the website if you make changes such as replacing the images, modifying the css styles, etc.

ProTips

Resize Images

I have made this as a npm package with gulp to automate image resizing and thumbnail generation. So if you're lazy like me then you can just do the following before you push your images to github.

1. Fork and clone the project to your computer
2. Go inside the project $ cd photography
3. Install all dependencies by $ npm install
4. Copy all your pictures (possibly jpg, the largest size available, straight from your camera) and put it inside images directory
5. Run $ gulp resize to resize the images and to generate thumbnails automatically
6. Push your changes to github.com by $ git add --all and $ git commit -m "a nice commit message" and then finally $ git push origin master

Contact Form

You can make the contact form work without the need of any server-side code. Just follow this article on github which uses a simple google script to send emails or to upload to a google spreadsheet when someone submits the form.

Credits

Thanks to AJ for the website template which I enhanced for jekyll.

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Proudly sponsored by Presentify and BrowserStack. Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

---

P.S. For any queries or concerns, you can reach out to me on Twitter. I'll try my best to help 🙏.