Deployment Guide
Your new Quarto academic website is ready for deployment! Here are the steps to get it online.
Quick Start
The site is currently running locally at: http://localhost:4200
To stop the preview server:
quarto preview --stopDeployment Options
1. GitHub Pages (Recommended)
# Navigate to your project directory
cd "Quarto website"
# Deploy to GitHub Pages
quarto publish gh-pages
# Follow the prompts to configure GitHub repository2. Netlify
- Push your project to a GitHub repository
- Connect Netlify to your repository
- Set build command:
quarto render - Set publish directory:
_site - Deploy automatically on every push
3. Vercel
- Push your project to a GitHub repository
- Import project in Vercel
- Vercel will auto-detect Quarto and configure build settings
- Deploy automatically
4. Manual Deployment
# Build the site
quarto render
# Upload contents of _site/ folder to your web serverPre-Deployment Checklist
Domain Configuration
If using a custom domain:
- GitHub Pages: Add CNAME file with your domain
- Netlify: Configure domain in site settings
- Vercel: Add domain in project settings
SSL/HTTPS
All modern hosting platforms provide free SSL certificates. Ensure your site uses HTTPS for: - Better SEO rankings - Secure connections - Professional appearance
Site Maintenance
Adding New Blog Posts
# Create new post directory
mkdir "blog/posts/YYYY-MM-DD-post-title"
# Create index.qmd with frontmatter:
---
title: "Your Post Title"
description: "Brief description"
author: "Joseph Frimpong"
date: "2024-01-15"
categories: [category1, category2]
---Updating Publications
Add new entries to _bibliography/papers.bib in standard BibTeX format.
Modifying Styling
Edit styles/custom.scss to customize colors, fonts, and layouts.
Performance Optimization
Your site is already optimized with: - ✅ Responsive images - ✅ Minified CSS/JS - ✅ Clean HTML structure - ✅ Fast loading times - ✅ Mobile-friendly design
Analytics & SEO
Consider adding: - Google Analytics - Search Console verification - OpenGraph meta tags (already included) - XML sitemap (auto-generated)
Support
For Quarto-specific issues: - Quarto Documentation - Quarto Community
For website content questions: - Review this README.md - Check example content in blog posts - Refer to original site structure
Backup Strategy
- Keep source code in Git repository
- Regular commits for content updates
- Export/backup
_bibliography/papers.bib - Save any custom assets/images
Your new academic website combines the best of modern web development with academic functionality. Enjoy showcasing your research and insights!