How to Update Your Personal Website
Your website is now set up to be completely manageable through YAML and Markdown files! No need to edit HTML directly.
π― Quick Start: Essential Files to Update
1. Personal Information (_data/personal.yml)
Update your basic information here:
name: "Alejandro Andres Juanes" # Your full name
email: "Alejandro.AndresJuanes@ista.ac.at" # Your email
title: "Researcher & Developer" # Your professional title
subtitle: "PhD Student in Computer Science" # Your current status
bio: | # Main description for your homepage
Welcome to my personal website! I'm a passionate researcher...
2. Professional Links (_data/links.yml)
Update your social media and professional profiles:
main_links: # Links shown prominently on homepage
- name: "LinkedIn"
url: "https://linkedin.com/in/your-profile" # β Update this!
- name: "GitHub"
url: "https://github.com/your-username" # β Update this!
3. Research Information (_data/research.yml)
Add your publications, projects, and collaborators:
publications:
- title: "Your Paper Title"
authors: "**Your Name**, Co-author Name"
venue: "Conference/Journal Name 2024"
description: "Brief description of your work..."
4. Resume/CV (_data/resume.yml)
Add your education and work experience:
education:
- degree: "Ph.D. in Computer Science"
institution: "Your University"
start_year: "2020"
end_year: "2024"
π Blog Posts
Create new blog posts by adding files to _posts/ following this format:
- Filename:
YYYY-MM-DD-title-of-post.md - Example:
2024-03-18-my-first-post.md
---
layout: post
title: "My First Blog Post"
date: 2024-03-18
categories: [Research, Academia]
---
Your blog post content goes here in Markdown format!
π¨ Customization
Colors & Theme
The website uses your custom color palette:
- Turquoise Surf (#06aed5) - Primary accent
- Cerulean (#086788) - Text and headers
- Bright Amber (#f0c808) - Highlights
- Papaya Whip (#fff1d0) - Light backgrounds
- Primary Scarlet (#dd1c1a) - Alerts
Navigation
Update the menu in _config.yml:
navigation:
- name: "Home"
url: "/"
- name: "Resume"
url: "/resume/"
π Publishing Changes
- Edit any YAML/Markdown files using your preferred text editor
- Commit and push to GitHub:
git add . git commit -m "Update personal information" git push - GitHub Pages will automatically rebuild your site (takes 1-2 minutes)
π File Structure Summary
π _data/ # All your content (EDIT THESE!)
βββ personal.yml # Basic info, bio, research interests
βββ links.yml # Social media and professional links
βββ research.yml # Publications, projects, presentations
βββ resume.yml # Education, experience, awards
π _posts/ # Blog posts (Markdown files)
βββ 2023-10-01-welcome.md
π images/ # Your photos
βββ profile.jpg # Your profile photo (500x500px recommended)
π _config.yml # Site settings and navigation
β Next Steps
- Update
_data/personal.ymlwith your information - Update
_data/links.ymlwith your social profiles - Add your publications to
_data/research.yml - Add your experience to
_data/resume.yml - Replace
images/profile.jpgwith your photo - Write your first blog post in
_posts/
π― Pro Tips
- Use
**Your Name**in author lists to make your name bold - Test locally by running
bundle exec jekyll serve - Dark mode automatically works - visitors can toggle with the moon/sun button
- All external links automatically open in new tabs
- The site is fully responsive and works great on mobile devices
Thatβs it! Your website will automatically update when you push changes to the main branch. π