4. Add an "upstream" remote for the original repository so you can stay abreast of bugfixes: `git remote add upstream git://github.com/uwsampa/research-group-web.git`.
5. Customize. Start with the `_config.yml` file, where you enter the name of the site and its URL.
The list of publications is in `bib/pubs.bib`. Typing `make` will generate `pubs.html`, which contains a pretty, sorted HTML-formatted list of papers. The public page, `publications.html`, also has a link to download the original BibTeX.
For both long-form blog posts and short news updates, we use Jekyll's blogging system. To post a new item of either type, you create a file in the `_posts` directory using the naming convention `YYYY-MM-DD-title-for-url.md`. The date part of the filename always matters; the title part is currently only used for full blog posts (but is still required for news updates).
To create a project, just create a markdown file in the `_projects` folder. Here are the things you can put in the YAML frontmatter:
-`title:` The project title.
-`notitle:` Set this to `true` if you don't want a title displayed on the project card. Optional.
-`description:` The text shown in the project card. It supports markdown.
-`people:` The people working on the project. This is a list of keys from the `_data/people.yml` file.
-`layout: project` This sets the layout of the actual project page. It should be set to `project`.
-`image:` The URL of an image for the project. This is shown on both the project page and the project card. Optional.
-`last-updated:` Date in the format of `YYYY-MM-DD`. The project cards are sorted by this, most recent first.
-`status: inactive` Set this to `inactive` if don't want the project to appear on the front page. Just ignore it otherwise.
-`link:` Set this to an external URL if this project has a page somewhere else on the web. If you don't have a `link:`, then the content of this markdown file (below the YAML frontmatter) will be this project's page.
-`no-link: true` Set this if you just don't want a project page for your project.
People are listed in a [YAML][] file in `_data/people.yml`. You can list the name, link, bio, and role of each person. Roles (e.g., "Faculty", "Staff", and "Students") are defined in `_config.yml`.
To set up deployments, edit the Makefile and look for the lines where `HOST` and `DIR` are defined. Change these to the host where your HTML files should be copied to.
To upload a new version of the site via rsync over ssh, type `make deploy`. A web hook does this automatically when you push to GitHub. Be aware that the Makefile is configured to have rsync delete stray files from the destination directory.
