Source code for my webpage
Perl HTML CSS TeX JavaScript Python Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_layouts
_plugins
_posts
bib
bibble
css
cv
fonts
img
job-search @ bb4d750
js
news
papers
research
.gitmodules
404.md
Makefile
README.md
_config.yml
_config_sandbox.yml
code.md
contact.md
cv.pdf
excellence.html
index.html
irene-zhang-cv.pdf
papers.html
publications.html
service.md
teaching.md
thesis.html

README.md

Irene's Webpage

This site uses Jekyll and bibble to generate a static personal webpage complete with publications, research and news.

Editing

Most pages are just Markdown files that you can edit directly.

News Items and Blog Posts

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][postsdir] 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).

The file must begin with YAML front matter. For news updates, use this:

---
layout: post
shortnews: true
---

For full blog posts, use this format:

---
layout: post
title:  "Some Great Title Here"
---

And concoct a page title for your post. The body of the post goes after the --- in either case.

Building and Deploying

The requirements for building the site are:

  • Jekyll: run gem install jekyll
  • Pybtex: run pip install pybtex
  • bibble: included as a submodule. Because git is cruel, you need to use git clone --recursive URL or issue the commands git submodule init ; git submodule update to check out the dependency.
  • ssh and rsync, only if you want to deploy directly.

make compiles the bibliography and the website content to the _site directory. To preview the site, run `jekyll serve`` and head to http://0.0.0.0:4000.

To upload a new version of the site via rsync over ssh, type make deploy.

If you use an alternative Python when building the bibliography, use make PYTHON=/path/to/python.