π QUICK REFERENCE CHEAT SHEET
One-Page Reference for Common Tasks
π DEPLOYING TO NETLIFY (First Time)
# 1. Build website
quarto render
# 2. Go to Netlify
https://app.netlify.com/drop
# 3. Drag docs/ folder to the page
# Done! Your site is live!π UPDATING YOUR WEBSITE
# 1. Edit your .qmd files
# 2. Rebuild
quarto render
# 3. Redeploy
# - Netlify: Drag new docs/ folder
# - GitHub: git add . && git commit -m "Update" && git pushπ WHICH FILE TO EDIT
| Want to Change | Edit This File |
|---|---|
| Home page | index.qmd |
| Services | services.qmd |
| Prices | pricing.qmd |
| Webinars | webinars.qmd |
| About page | about.qmd |
| Contact info | contact.qmd |
| Colors | custom.scss & styles.css |
| Menu/Navigation | _quarto.yml |
| Footer | _quarto.yml |
π» ESSENTIAL COMMANDS
# Build website
quarto render
# Preview locally (opens in browser)
quarto preview
# Check Quarto version
quarto --version
# Check Quarto is working
quarto checkπ¨ QUICK CUSTOMIZATION
Change Primary Color
Edit custom.scss:
$primary: #0047AB; // Change to your colorAdd Your Logo
- Save logo as
logo.pngin root folder - Run
quarto render - Redeploy
Change Site Name
Edit _quarto.yml:
website:
title: "Your New Title"π IMPORTANT URLS
| Service | URL |
|---|---|
| Netlify Drop | https://app.netlify.com/drop |
| Netlify Dashboard | https://app.netlify.com/ |
| Quarto Docs | https://quarto.org/docs/ |
| PageSpeed Insights | https://pagespeed.web.dev/ |
| DNS Checker | https://dnschecker.org |
π CONTACT INFO TO UPDATE
Edit contact.qmd and _quarto.yml (footer):
- β Email addresses
- β Phone numbers
- β Physical address
- β WhatsApp links
- β Social media URLs
β‘ COMMON TASKS
Add a New Webinar
- Edit
webinars.qmd - Copy existing webinar card section
- Update date, time, title, description
- Run
quarto render - Redeploy
Update a Price
- Edit
pricing.qmd - Find the price in the table
- Update the number
- Run
quarto render - Redeploy
Change Contact Email
- Edit
contact.qmd(main contact page) - Edit
_quarto.yml(footer) - Search for old email, replace with new
- Run
quarto render - Redeploy
π TROUBLESHOOTING
| Problem | Solution |
|---|---|
| βquarto not foundβ | Install from quarto.org |
| Build fails | Check error message, verify .qmd files |
| Changes donβt show | Did you run quarto render? |
| Site looks broken | Upload entire docs/ folder |
| Links donβt work | Check URLs in .qmd files |
π DEPLOYMENT CHECKLIST
Before deploying: - [ ] Contact info is correct - [ ] Prices are accurate - [ ] Links work (test locally with quarto preview) - [ ] No βTODOβ or placeholder text - [ ] Run quarto render successfully - [ ] docs/ folder created
π― FILE LOCATIONS
MTJ_Website/
βββ *.qmd files β Edit these for content
βββ _quarto.yml β Site configuration
βββ styles.css β Styling
βββ custom.scss β Colors
βββ docs/ β Deploy this folder
βββ *.md files β Documentation (don't deploy)
π± TESTING
Before Deploying
quarto preview
# Opens at http://localhost:4200
# Test all pages and linksAfter Deploying
π NETLIFY URLS
After deployment:
Home: https://yoursite.netlify.app/
Services: https://yoursite.netlify.app/services.html
Pricing: https://yoursite.netlify.app/pricing.html
Webinars: https://yoursite.netlify.app/webinars.html
About: https://yoursite.netlify.app/about.html
Contact: https://yoursite.netlify.app/contact.html
π‘ QUICK TIPS
- Always run
quarto renderbefore deploying - Test locally with
quarto previewfirst - Edit .qmd files, not .html files
- Deploy the
docs/folder, not individual files - Backup your files before major changes
π NEED HELP?
Read These: 1. NETLIFY_QUICK_START.md (5-min deploy) 2. NETLIFY_DEPLOYMENT.md (complete guide) 3. PROJECT_STRUCTURE.md (find files) 4. DOCUMENT_INDEX.md (all docs)
Contact: - π§ info@mtjdataanalytics.com - π± +234 901 944 1200
π MOST COMMON WORKFLOW
# 1. Make changes to .qmd files
vim index.qmd # or use any text editor
# 2. Rebuild
quarto render
# 3. Preview (optional but recommended)
quarto preview
# 4. Deploy to Netlify
# Drag docs/ folder to app.netlify.com/drop
# Done! β
Print or save this page for quick reference!
Β© 2025 MTJ Data Analytics