Glenn Matlin's Personal Website

Personal academic website featuring blog posts, research projects, publications, and technical documentation.

🚀 Quick Start

Prerequisites

• Quarto (v1.7+)
• Python 3.12+
• UV package manager

Setup

1. Clone the repository

   git clone https://github.com/gmatlin/website.git
   cd website

2. Install UV (if not already installed)

   curl -LsSf https://astral.sh/uv/install.sh | sh

3. Install dependencies

   uv sync

4. Start development server

   quarto preview

   Your site will be available at http://localhost:4000

📁 Project Structure

website/
├── _quarto.yml          # Main configuration
├── index.qmd            # Homepage
├── about.qmd            # About page
├── blog.qmd             # Blog listing
├── projects.qmd         # Projects listing
├── publications.qmd     # Publications listing
├── post/               # Blog posts
├── project/            # Project pages
├── publication/        # Publication entries
├── knowledgebase/      # Technical docs
├── assets/             # Images and media
└── styles.css          # Custom styling

✍️ Adding Content

New Blog Post

# Create post directory
mkdir post/my-new-post

# Create post content
cat > post/my-new-post/index.md << 'EOF'
---
title: "My New Post"
date: 2024-01-20
categories: [AI, Research]
image: featured.png
---

Your post content here...
EOF

New Project

# Create project directory
mkdir project/my-project

# Add project details
# See project/flame/index.md for template

New Publication

# Create publication directory
mkdir publication/paper-2024

# Add publication metadata
# See publication/example/index.md for template

🛠️ Development

Build the site

quarto render

Preview with live reload

quarto preview

Check for issues

quarto check

🚀 Deployment

The site automatically deploys to GitHub Pages when you push to the main branch.

Manual deployment

quarto publish gh-pages

🎨 Customization

• Styles: Edit styles.css for custom styling
• Navigation: Modify _quarto.yml for menu structure
• Theme: Change theme in _quarto.yml (currently using "cosmo")

📚 Documentation

• Full Project Documentation - Comprehensive guide
• Improvement Plan - Roadmap for enhancements
• Quarto Docs - Official Quarto documentation

🐛 Troubleshooting

Common Issues

1. Preview not working: Ensure Quarto is installed and in PATH
2. Build errors: Check YAML frontmatter syntax
3. Missing dependencies: Run uv sync to install

Useful Commands

# Clear cache and rebuild
rm -rf _site .quarto
quarto render

# Check Quarto installation
quarto check

# Update Quarto
# Visit https://quarto.org/docs/get-started/

📄 License

This project is licensed under the MIT License - see LICENSE.md for details.

📧 Contact

Glenn Matlin - [email protected]

---

Built with ❤️ using Quarto