Jon Lee

Website Guide

Welcome to my guide for setting up and editing your website. Here you’ll find everything you need to maintain your website. If you have any questions, contact me.

Setting up your project

  1. I'm starting from complete scratch. How do I get started?
    You'll need to set up accounts for a few services, and then set up your computer. Tell me more >>
  2. Which accounts do I need to set up?
    You'll most likely need to create accounts on Porkbun (for your domain), GitHub (for your website), and Formspree (for your contact form). Tell me more >>
  3. What do I need to have on my laptop to make changes to my website?
    GitHub Desktop and Sublime Text 4. Tell me more >>
  4. How can I preview changes I make to my website before publishing them publicly to the internet?
    Install Ruby and Jekyll. A command in Terminal runs a temporary local server. Tell me more >>

Editing your content

  1. How can I add formatting style to my text?
    Use Markdown to format your text. Certain formatting is done automatically for you, like converting straight quotes to smart ones. Tell me more >>
  2. What's the best way to deal with images?
    For website assets, use a service like or For high-quality photography, go for large pixel dimensions with higher compression, with a soft limit of 400 KB per image. Tell me more >>
  3. What's the best way to deal with videos?
    It's best to have the video published in a service like YouTube or Vimeo. We can embed the video into your website. Tell me more >>
  4. How do I make changes to the site?
    Open the folder containing your website in Sublime Text. Make your changes. When you are done, publish them. Tell me more >>

Publish your content

  1. I've made some changes to my website on my computer. How do I publish them to the web?
    Make sure you've committed the changes in GitHub Desktop with "Commit to main". Then "Push origin". Give GitHub about 2 minutes before trying to reload the website. Tell me more >>