Deployment Guide for Netlify
Option 1: Using GitHub (Recommended)
Step 1: Prepare Your Repository
Backup your old distill blog (optional but recommended):
git checkout -b backup-distill git push origin backup-distillSwitch to main branch and update:
git checkout mainAdd your new Quarto website files:
git add . git commit -m "Migrate from distill to Quarto" git push origin main
Step 2: Update Netlify Build Settings
Go to your Netlify site dashboard:
- Site settings → Build & deploy → Build settings
- Update the settings:
- Build command:
quarto render - Publish directory:
_site
- Build command:
- Environment variables → Add:
- Key:
QUARTO_VERSION - Value:
1.4.0(or latest version)
- Key:
Step 3: Trigger Deploy
- Click Deploys → Trigger deploy → Deploy site
- Your new Quarto site will build and deploy!
Option 2: Manual Deployment
If you prefer to deploy manually without CI/CD:
Build your site locally:
quarto renderDeploy the
_sitefolder:Drag and drop the
_sitefolder to Netlify’s deploy pageOr use Netlify CLI:
npm install -g netlify-cli netlify deploy --prod --dir=_site
Files Included for Netlify
netlify.toml- Netlify configuration file.gitignore- Already excludes_sitefolder
Important Notes
Remove old distill files: Delete these if they exist:
_site.yml(replaced by_quarto.yml)- Old R Markdown files (.Rmd)
- distill-specific configuration
Custom domain: If you have a custom domain, keep your DNS settings in Netlify
Redirects: The
netlify.tomlincludes a catch-all redirect for client-side routingBuild time: First build may take 2-3 minutes
Troubleshooting
Build fails with “quarto: command not found”
Make sure QUARTO_VERSION environment variable is set in Netlify.
CSS/styling issues
Clear your browser cache or do a hard refresh (Ctrl+Shift+R).
404 errors
Check that publish directory is set to _site (not _site/ or docs).