hirusha-adi / photos

Photos Website | Hirusha Adikari

🖥 Online Preview

Website with display my photos. 

📂 Folder Structure

./
├───assets          # Code for the main site
|   |               # -----
│   ├───img         # Favicon + Profile Picture
│   └─── ...        # Other Code
|
├───media           # Images generated by thumbsup
|   |               # -----
│   ├───large       # Compressed, full sized images - used in both galleries
│   ├───small       # Small sized images - for thhumbsup only
│   └───thumbs      # Extremely small image resolution - for thhumbsup only
|
├───original_photos # High Quality original photos.
|                   # Not used anywhere. Used to generat thhumbsup images
|
└───public          # Code for thhumbsup
    |               # -----
    ...

Guide for Windows

🔌 Prerequisites

• Download and install these:
  • Python
  • Nodejs (with npm)

📥 Setting up thumbsup

1. Install thumbsup witn npm, globally.

npm install -g thumbsup

2. Download GraphicsMagick (Installer) and install it.

3. Download exiftool (Windows Executable), extract it and copy it to a folder.

4. Add both of these folders to System PATH (GraphicsMagick installation folder and the folder which has our exiftool.exe)

📚 Adding new images

• Copy your high quality images into ./original_photos

  • You may compress it with File Converter
  • All images should be in .jpg

🛠 Updating the website

• Run the command below

  thumbsup --input ./original_photos --output ./gallery --theme cards --index quick.html --title "Hirusha Adikari | Photography" --footer "Copyright © 2021-2024 Hirusha Adikari" --albums-output-folder "albums" --albums-from %path

  

• The newly compressed images and the other thumbsup files will be generated inside ./gallery

• Rename ./gallery/index.html to ./gallery/quick.html

• Move and replace everything from ./gallery to ./

• Run the gallery.py file, to update the gallery of my main site

  python gallery.py
  

• Test with a local server, for example using VSCode Live Server.

• Commit and push changes to your GitHub repository, and wait for GitHub Pages to update the live site.

Guide for Ubuntu

🔌 Prerequisites

• Open a terminal and run the following commands to install the necessary tools:

  sudo apt-get update
  sudo apt-get install python3 nodejs npm -y

📥 Setting up thumbsup

1. Install thumbsup with npm, globally.

   sudo npm install -g thumbsup

2. Install GraphicsMagick:

   sudo apt-get install graphicsmagick -y

3. Install exiftool:

   sudo apt install exiftool -y

📚 Adding new images

• Copy your high quality images into ./original_photos

  • You may compress them using tools like File Converter (Windows Only) or any other tools.
  • Ensure all images are in .jpg format.

🛠 Updating the website

• Run the following command:

  thumbsup --input ./original_photos --output ./gallery --theme cards --index quick.html --title "Hirusha Adikari | Photography" --footer "Copyright © 2021-2024 Hirusha Adikari" --albums-output-folder "albums" --albums-from %path

  

• The newly compressed images and other thumbsup files will be generated inside ./gallery.

• Rename ./gallery/index.html to ./gallery/quick.html:

  mv ./gallery/index.html ./gallery/quick.html

• Move and replace everything from ./gallery to ./:

  mv ./gallery/* ./

• Run the ./gallery.py file to update the gallery on your main site:

  python3 gallery.py

• Test with a local server, for example using VSCode Live Server.

• Commit and push changes to your GitHub repository, and wait for GitHub Pages to update the live site.

License

Licensed under the MIT License