Editing this site

Everything on this site lives in a GitHub repository. You can edit any of it in the browser: open the file on GitHub, click the pencil icon, make your change, and click Commit changes. The site rebuilds itself in about a minute.

Where things live

To change…	Edit this file
A paper	`_data/publications.yml`
A person, or move someone to alumni	`_data/people.yml`
A news item	`_data/news.yml`
A research area	`_data/research.yml`
Gallery photos	upload to `assets/gallery/<album>/`; titles and captions in `_data/gallery.yml`
A wiki page	`_wiki/<page-name>.md`
Home, Join, Visit pages	`index.html`, `join.html`, `visit.html`
Images	`assets/img/` (people photos in `assets/people/`, wiki images in `assets/wiki/`)

Add a paper

Copy an existing entry in _data/publications.yml, paste it at the top of the right year, and change the fields:

- year: 2027
  type: journal          # journal | conference | abstract | preprint | patent
  authors: A. Student, B. Student, N. A. Hall
  title: Title in sentence case
  venue: Journal name
  details: 12(3), 456    # volume(issue), pages or article number
  doi: 10.xxxx/xxxxx     # or url: https://...
  cover: Cover article, March 2027   # optional
  highlight: true        # optional: show under its research area

YAML is picky about indentation (two spaces) and about colons inside text. If a title contains a colon, wrap the whole title in double quotes.

Add yourself

In _data/people.yml, add an entry under phd: (or postdocs: / undergrads:). For a photo, upload a square JPG (at least 400 × 400 px) to assets/people/ and set photo: yourname.jpg.

When you graduate, move your entry to alumni: and fill in year: and now:.

Add a news item

Add an entry at the top of _data/news.yml:

- date: 2027-01-15
  title: Short headline
  text: One or two sentences.
  link: https://doi.org/...   # optional
  tag: Paper                  # Paper, Cover, Award, Talks, Recruiting…

Add photos to the gallery

The Gallery page builds itself from the photos in assets/gallery/. One folder is one album, so there is no file to edit.

On GitHub, open the album folder, for example assets/gallery/team-building.
Click Add file → Upload files, drag your photos in (up to 100 at a time), then Commit changes.

They show up on the site in about a minute. An album stays hidden until it has its first photo.

Before you upload:

JPG or PNG only. iPhone .HEIC files do not show in most browsers; export them as JPEG first.
Shrink big photos to about 2400 pixels on the long side, usually under 1 MB. On a Mac: open in Preview, Tools → Adjust Size, then File → Export as JPEG. The whole site has to stay under GitHub’s 1 GB limit.
Name files so they sort by date, such as 2026-10-lake-travis-1.jpg (lowercase, hyphens, no spaces). The newest name comes first, and the first photo of an album is shown large.
Ask first. The site is public, so upload a photo only if everyone in it is fine with being shown, and check the background for screens or whiteboards with unpublished work.

New album: on the assets/gallery page, click Add file → Upload files and drag in a whole folder of photos. The folder name becomes the album name. To give it a nicer title, a description, or a place in the order, add it to _data/gallery.yml.

Captions are optional. In _data/gallery.yml, under the album:

- folder: team-building
  title: Team building
  captions:
    2026-10-lake-travis-1.jpg: Kayaking on Lake Travis, October 2026

Write a wiki page

Copy _templates/wiki-page.md into _wiki/ and rename it, e.g. _wiki/ldv-setup.md (lowercase, hyphens). That name becomes the URL: /wiki/ldv-setup/.
Fill in the header: title, category (must match one in _data/wiki_categories.yml), order, summary, authors, updated.
Write in Markdown. Put images in assets/wiki/ and reference them as ![caption]({{ '/assets/wiki/your-image.jpg' | relative_url }}).

Keep it public-safe. No account numbers, P-card details, vendor contacts, door codes, export-controlled or NDA material, or unpublished results. Those go on the internal wiki.

Preview locally (optional)

bundle install
bundle exec jekyll serve
# open http://localhost:4000

Something wrong or out of date? Fix it: edit this page on GitHub. See Editing this site.