Updating This Site
Updating This Site
The sections below capture the files we updated while porting content from the legacy old_html_website/ directory. Use this as a checklist whenever you refresh the site.
Key Content Files
_config.yml– Site-wide metadata (title, sidebar bio, contact info, production URL/baseurl)._pages/index.md– Home page narrative, hero image, selected publications, teaching highlights, contact note._data/navigation.yml– Header links (currently Publications and Teaching; add- title: "CV"withurl: /#cvto re-enable a top-level CV anchor)._publications/*.md– Individual paper entries with metadata, links to PDFs/arXiv/DOI, and short descriptions._teaching/*.md– TA roles with venue, semester, and supporting notes.images/ChrisSquare.jpg,images/chriscrop2.jpg– Profile and homepage images.files/ILG_Single_Column_Nov_8_2024.pdf,files/LEAP_ILG_Nov_8_2024.pdf,files/POPL_23.pdf– Linked artifacts (paper/workshop copies).
Quick Update Workflow
- Edit content locally
- Tweak
_config.ymlfor new bio links or sidebar details. - Update
_pages/index.mdwith fresh paragraphs, activities, and image references. - Add or modify
_publications/*.mdand_teaching/*.mdentries; copy new PDFs intofiles/.
- Tweak
- Preview
bundle exec jekyll serve -l -H localhost --baseurl ''Inspect
http://localhost:4000to ensure navigation, images, and publication links render. - Deploy
scripts/deploy_public_html.shThe script rebuilds the site (
bundle exec jekyll build) andrsyncs_site/toccwatson@eniac.seas.upenn.edu:public_html/(override withREMOTE/REMOTE_PATHif needed). - Verify live
- Open
https://www.seas.upenn.edu/~ccwatson/in a fresh browser session. - Spot-check publications, teaching pages, and downloads under
/files/.
- Open
Tips
- Keep
.gitignore(now ignoring.DS_Store) intact to avoid committing macOS metadata. - When adding new collections (talks, portfolio, etc.), mirror the pattern above: add Markdown entries under the relevant
_collection/directory, adjust_data/navigation.yml, and link assets underimages/orfiles/. - Run
npm run build:jsif you ever edit JavaScript inassets/js/before deploying.
