layout
default

Here's how to edit this website!

Overview

1. Checkout this repo on github
2. Make changes and push to github (make sure you have collaborator privileges, and see later sections for details on specific kinds of changes)
3. Changes should appear automatically on the lab website.

Specific kinds of changes

How to add a new page to the website

1. make a markdown file, e.g. new-file.md in the top of the website directory

2. add this to the top of the markdown file:

    ---
    layout: default
    ---
   

3. if you want this page to appear in the navbar, add another value to the header:

    ---
    layout: default
    title: New Page
    ---
   

4. visit langcog.stanford.edu/new-page.html.

How to add a person to the website

1. go to the file _data/langcoglab.yml

2. find (or add) whatever role they play in the lab (e.g. Principal Investigator, Graduate Students, Postdocs, Lab Alums), and add a new person to that role.

    - role: [WHATEVER ROLE]
      people:
        - [OTHER PEOPLE]
        - name: New Person
          img: newPerson.jpg
          baby: babyPerson.jpg
          webpage: //www.stanford.edu/~newP
          bio:
            - >
              A paragraph of this person's bio.
            - >
              Another paragraph of this person's bio.
        - [OTHER PEOPLE]
   

How to add a publication to the website

1. go to the file _bibliography/citations.bib and add the publication.

How to add an image to the people carousel

1. got to the file _data/carousel.yml

2. add a new image to the end of the file

    - [OTHER IMAGES]
    - image: my-new-image.jpg
      label: "A description of my new image"
      alt: "if you want, you can add a line of alt text. otherwise, the label will be the alt text."
   

Set up

Download Ruby Gems. To set up installing ruby gems without sudo access, these lines should be in your ~/.bash_profile (or ~/.bashrc or whatever you use):

PATH=$PATH:~/.gem/bin:~/bin
export GEM_HOME=~/.gem

Once you've re-logged on or sourceed your profile file, you can install jekyll and jekyll-scholar using gem. This site uses jekyll (3.9.3) and jekyll-scholar (5.16.0).

gem install jekyll -v 3.9.3
gem install jekyll-scholar -v 5.16.0

Note that while jekyll is compatible with GitHub pages, jekyll-scholar is not.

This website uses a custom Github Action Workflow to publish the website after a push is made to the main directory.

For local debugging, one could run

jekyll build

and then navigate to _site/index.html. Unfortunately, the links in this repo are currently hard-coded with the assumption that all files are present at the host (in the online version, http://langcog.stanford.edu/, in the local version file://), so further abstraction and modifications would have to be made in order to actually navigate the site locally...