Skip to content

🎨 Avatar Forge: Crafting Your Digital Portrait

"A blurred silhouette does not inspire fear — or trust. Let us give you a face." — The Portrait Artist

🎯 Quest Objectives

  • Find or create an avatar image
  • Host the image at an accessible URL
  • Update your contributor data file
  • Verify the avatar renders on your profile

📖 Background

Your character sheet currently shows a GitHub-generated identicon. While functional, a custom avatar makes your profile uniquely yours.

🗺️ Quest Steps

Step 1: Choose Your Avatar

Options for sourcing an avatar:

Method Difficulty Notes
GitHub profile photo Easiest Use https://github.com/YOUR_USERNAME.png
Upload to repo Easy Add to assets/images/contributors/
External URL Easy Any publicly accessible image URL
Generate with AI Fun Use an AI art tool for a fantasy portrait
Custom art Advanced Draw your own class-themed portrait

Recommended size: 200×200px or larger, square aspect ratio.

Step 2: Update Your Data File

Edit _data/contributors/YOUR_USERNAME.yml — add or update only the avatar: key inside the existing profile: block, so you don't overwrite any other profile fields already there:

profile:
  avatar: "https://github.com/YOUR_USERNAME.png"  # or your custom URL

Or if hosting in the repo:

profile:
  avatar: "/assets/images/contributors/YOUR_USERNAME.png"

Step 3: Host Locally (Optional)

If adding the image to the repo:

mkdir -p assets/images/contributors
cp <PATH_TO_YOUR_AVATAR> assets/images/contributors/YOUR_USERNAME.png
# Replace <PATH_TO_YOUR_AVATAR> with the real path to your image file, e.g. ~/Downloads/avatar.png

Step 4: Verify

Build the site and check your profile page. This assumes the site repo is already cloned and bundled from the prerequisite Forge Your Character quest — run bundle install first if you haven't yet:

bundle install
bundle exec jekyll serve
# Visit http://localhost:4000/contributors/YOUR_USERNAME/

Your avatar should appear in the circular frame at the top of your character card.

  • Avatar displays correctly
  • Fallback still works if image fails to load — test by temporarily pointing avatar: at a broken URL and confirming the GitHub identicon (or a default placeholder) still renders instead of a blank/broken image

🏆 Reward: Portrait Artist Badge 🎨

Once your avatar is live, you've earned the Portrait Artist badge (+50 XP).

"Now the realm shall know your face. Go forth, adventurer."

🕸️ Knowledge Graph

Structured wiki-links connect this quest to the IT-Journey knowledge graph. Open the Obsidian Graph View to explore connections.

Level hub: [[Level 001 - Journeyman Challenges]] Overworld: [[🏰 Overworld - Master Quest Map]] Prerequisites: [[Forge Your Character: Crafting Your Contributor Identity]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]