kixlab.github.io

Our lab's website. We are using Jekyll, a static website generator.

Adding content

Member information

1. Go to _data/members.yml
2. Edit or add what you want
3. You can add your name, email, homepage

For the picture, please choose an image with 1:1 aspect ratio like the others. (Suggested size: 600x600px) Place the file at assets/img/members/your_name.jpg and reference it in members.yml with just your_name.jpg.

News and projects

1. Add a new file in _posts/news/ or _posts/projects/ (for example, by duplicating and renaming an existing one).
2. You can write the content in Markdown format
3. If the post has a picture, place it in assets/img/news, or assets/img/projects, respectively.

Publications

1. Go to _data/publications.yml
2. Append the list by copy-pasting one of the items and filling in your information.

How to check changes you made locally

Please check that the site still works before you submit a pull request. You can do this by:

bundle install && jekyll serve

or, if you want to use Docker

docker run --rm -p 4000:4000 -v "$(pwd):/src" -it zxzl/kixlab-homepage jekyll serve --host=0.0.0.0

Then visit localhost:4000 in your browser.

How to branch, commit and push

Please don't commit directly to master, if you can avoid it.

1. Create a new branch from master: git checkout -b my-branch-name
2. Add and commit your changes. git status to check what you did, git add ... to add new files, git commit -m "Put a comprehensive summary of your changes here"
3. Push your new branch: git push (depending on your settings, git will complain and tell you what to do instead).
4. Go to https://github.com/kixlab/kixlab.github.io and create a new Pull Request for your branch.
5. Someone with authority will go on and merge your changes.