pr

DEPLOYMENT-GUIDE.md

@@ -0,0 +1,44 @@
+# Portfolio Deployment Guide
+
+## How to deploy to ireney2050.github.io
+
+### Option A: Replace your existing repo contents
+1. Back up your current repo (or create a branch)
+2. Delete all existing files in your `ireney2050.github.io` repo
+3. Copy all files from this `portfolio/` folder into the repo root
+4. Commit and push — GitHub Pages will build automatically
+
+### Option B: Fresh start
+1. Clone your repo: `git clone https://github.com/ireney2050/ireney2050.github.io.git`
+2. Remove old files, copy in the new portfolio files
+3. Push to `main` branch
+
+### Testing locally (optional)
+```bash
+cd portfolio
+bundle install
+bundle exec jekyll serve
+```
+Then visit http://localhost:4000
+
+## File structure
+```
+_config.yml          # Jekyll configuration
+_layouts/
+  default.html       # Base HTML layout
+  project.html       # Individual project page layout
+_includes/
+  nav.html           # Navigation bar
+  footer.html        # Footer
+_projects/           # One .md file per project (8 total)
+assets/css/
+  style.css          # All styles
+index.html           # Homepage (hero, skills, projects, experience, contact)
+Gemfile              # Ruby dependencies
+```
+
+## Customisation notes
+- To add your resume as a download: place the PDF in `assets/` and add a button link in the hero section
+- To add a headshot: place the image in `assets/` and add an `<img>` tag in the hero section
+- Colours can be changed via CSS variables at the top of `style.css`
+- To add/remove projects: create/delete files in `_projects/` and update `index.html`

Gemfile

@@ -1,7 +1,8 @@
-# frozen_string_literal: true
-
 source "https://rubygems.org"
-gemspec
 
-gem "jekyll", ENV["JEKYLL_VERSION"] if ENV["JEKYLL_VERSION"]
-gem "webrick", "~> 1.7"
+gem "jekyll", "~> 4.3"
+gem "kramdown-parser-gfm"
+
+group :jekyll_plugins do
+  gem "jekyll-seo-tag"
+end

_config.yml

@@ -1,43 +1,32 @@
-# Welcome to Jekyll!
-#
-# This config file is meant for settings that affect your whole blog, values
-# which you are expected to set up once and rarely need to edit after that.
-# For technical reasons, this file is *NOT* reloaded automatically when you use
-# 'jekyll serve'. If you change this file, please restart the server process.
-
 # Site settings
-title: Your awesome title
-email: your-email@domain.com
-description: > # this means to ignore newlines until "baseurl:"
-  Write an awesome description for your new site here. You can edit this
-  line in _config.yml. It will appear in your document head meta (for
-  Google search results) and in your feed.xml site description.
-baseurl: "" # the subpath of your site, e.g. /blog
-lang: "en"
-url: "http://localhost:4000" # the base hostname & protocol for your site
-twitter_username: jekyllrb
-github_username:  jekyll
-disqus_username:
+title: Irene Yuan | Data & Analytics
+description: "Portfolio of Irene Yuan — Data Analyst specialising in customer analytics, BI, and applied AI."
+url: "https://ireney2050.github.io"
+baseurl: ""
+
+# Collections
+collections:
+  projects:
+    output: true
+    permalink: /projects/:path/
 
 # Build settings
 markdown: kramdown
-permalink: /:categories/:title/
-
-# Posts settings
-future: true
-safe: false
-lsi: false
-excerpt_separator: "\n\n"
-
-# Theme settings
-compress_html:
-  comments: ["<!-- ", " -->"]
-  clippings: all
-  endings: all
-
-
-sass:
-  style: compressed
-
-
-images: '/assets/images'
+highlighter: rouge
+kramdown:
+  input: GFM
+  syntax_highlighter: rouge
+
+# Defaults
+defaults:
+  - scope:
+      path: ""
+      type: "projects"
+    values:
+      layout: "project"
+
+# Exclude
+exclude:
+  - README.md
+  - Gemfile
+  - Gemfile.lock

_includes/footer.html

@@ -1,4 +1,3 @@
-<footer class="blog-footer content-wrapper">
-  <p>&copy; <span class="full-year"></span> {{ site.title }}</p>
+<footer class="site-footer">
+  <p>&copy; {{ 'now' | date: '%Y' }} Irene Yuan. Built with Jekyll &amp; hosted on GitHub Pages.</p>
 </footer>
-<script src="{{ site.baseurl }}/assets/js/scripts.js"></script>