rework agin

Author: quantumbagel

README.md

@@ -1,53 +1,63 @@
-# the quantumbagel developer portfolio
+# Portfolio template generator
 
-Welcome to the repository for my personal portfolio website, hosted at [quantumbagel.github.io](https://quantumbagel.github.io). This is version 2 of my site, rebuilt from the ground up to be more dynamic, modern, and easily maintainable.
+This repository builds a static portfolio site for GitHub Pages using:
 
-## Overview
+1. `site.toml` for all customizable content/configuration
+2. HTML templates in `templates/` with placeholders like `{user.name}`
+3. `generator.py` to render templates and output `index.html`
 
-This website serves as a showcase for my software development projects, experience, and skills. It is designed to be a clean, professional, and dark-mode-ready single-page application.
+## Project structure
 
-## Tools:
+- `site.toml` - template data and options (user info, sections, projects, skills, redirects)
+- `templates/index.html` - main page template
+- `templates/partials/*.html` - reusable section templates
+- `templates/redirect.html` - redirect page template
+- `generator.py` - TOML loader + placeholder renderer + static site generator
+- `index.html` - generated output file used by GitHub Pages
 
-- **Frontend:** 
-  - [Tailwind CSS](https://tailwindcss.com/) for styling and layout.
-  - [Ionicons](https://ionicons.com/) for clean, vector-based iconography.
-  - [Inter Font](https://rsms.me/inter/) for modern typography.
-  - [Python](https://www.python.org/) script to manage content and generate the static site.
-  - `htmlmin` for production-ready HTML minification.
-  - [GitHub Pages](https://pages.github.com/) for seamless deployment.
+## Configuration
 
-## cool things it dodes
+### Main site data
 
-- Automatically detects user preferences and provides a polished dark experience.
-- Interactive filtering for different categories (Discord Bots, Internships, etc.) and project-specific modals for more detail.
-- Fully responsive layout that looks okayish on mobile devices.
-- Content is decoupled from the layout, allowing for quick updates by editing a single Python file. (and honestly its pretty fun to code in python)
+Edit `site.toml` to customize:
 
-## Project Structure
+- `user` and `user.social`
+- `meta`, `sections`, `contact`, `footer`
+- `content.about`, `content.taglines`, `experiences`
+- `skills.languages` and `skills.technologies`
+- `projects` and `project_filters`
 
-- `generator.py`: The core of the project. All portfolio data (projects, skills, experience) is defined here. When run, it injects this data into an HTML template and outputs a minified `index.html`.
-- `index.html`: The final, minified production file used by GitHub Pages.
-- `tailwind.js`: tailwind library file
-- `font.css`: The fonts
-- `pfp.webp`: Profile picture
+### Redirects
 
-## If you want to use this
+Redirects are generated from `[redirects]` keys:
 
-To update the website or run it locally:
+```toml
+[redirects]
+resume = "https://google.com"
+```
+
+This writes `resume/index.html` so `/resume` redirects to that URL.
+
+## Template placeholders
+
+Templates use dot-path placeholders, for example:
+
+- `{user.name}`
+- `{meta.description}`
+- `{content.project_cards_html}`
+
+The generator replaces these automatically using `site.toml` values and generated HTML blocks.
+
+## Build
+
+Install optional minification dependency:
 
-### Prerequisites
-Ensure you have Python installed. You will also need the `htmlmin` library:
 ```bash
 pip install htmlmin
 ```
 
-### Updating Content
-Open `generator.py` and modify the data structures at the top of the file (e.g., `PERSONAL_INFO`, `ABOUT_ME`, `PROJECTS`).
+Generate the site:
 
-### Rebuilding the Site
-Run the generator script to apply your changes and rebuild the minified `index.html`:
 ```bash
-python generator.py
+python3 generator.py
 ```
-
-*note that even though it is forked from vcard, that was v1 and this is completely original code*