Personal Portfolio Setup Guide
Personal Portfolio Setup Guide
This document contains the technical details of the Jekyll setup for devanshu06.github.io. This file is named .md but not tracked as a page/post, so it won’t appear on your site.
Core Configuration
- Theme: Minimal Mistakes (Remote Theme).
- Skin:
default. - Collections:
projects: Defined in_config.yml. Files are stored in_projects/.posts: Standard Jekyll blog posts stored in_posts/.
Custom Styling & UI Fixes
All custom CSS is located in _includes/head/custom.html. Current hacks include:
- Hiding Navigation: Previous/Next buttons on projects and blogs are hidden via
.paginationand.page__nav { display: none !important; }. - Hiding RSS: Removed RSS icons from the footer.
- Favicon: Replaced the profile photo with a terminal icon (
assets/images/favicon.svg) with a#00ff00green stroke.
Features & Integrations
- Cloudflare Analytics: Script added to
_includes/head/custom.html. - Project Structure:
projects.md: Uses a Liquid loop to fetch fromsite.projects._config.yml:defaultsare set to ensurewidelayout andauthor_profile: truefor all pages.
- Future-Dating Fix: If a project or blog post doesn’t show up (404), ensure the
datein front matter is not in the future (Jekyll won’t build future-dated posts by default).
Content Management
- Adding Projects: Create a new
.mdfile in_projects/. Ensure it hastitle,excerpt, anddate. - Adding Blogs: Create a new
.mdfile in_posts/with the formatYYYY-MM-DD-title.md.
Troubleshooting
- Missing Projects: Check
_config.ymlto ensure theprojectscollection is defined undercollections:. - Broken Links: Check
permalinksettings in front matter vs. theblog_urlused in project files.