To build the website locally, clone the repo with:
git clone https://github.com/penndsg/website_source.git
Make sure you have ruby installed (preferrably using RVM). If you don't have the bundler
gem installed, install it by typing
gem install bundler
Then install necessary Ruby dependencies by running bundle install
from within the website_source
directory. After this, the site can be be built with:
jekyll build
This creates the static website files in the _site
directory. To view the site, run jekyll serve
(still from within the website_source
directory) and point a browser to http://localhost:4000/
. More information on Jekyll can be found here.
To add a new member, use the new_member.py
script. For example, to add John Doe, type
python new_member.py "John Doe"
This will create a file with a path like members/_posts/2016-12-14-john-doe.md
. The file will look something like this:
---
layout: member
title: "John Doe"
degree: "[Degree] [Program] [Grad Year]"
# cv: /pdfs/members/john-doe-cv.pdf
# resume: /pdfs/members/john-doe-resume.pdf
# twitter: your-twitter-handle
# github: your-github-handle
# bitbucket: your-bitbucket-handle
# scholar: your-google-scholar-id
# linkedin: your-linkedin-id (the part that goes after linkedin.com/in/)
# researchgate: your-researchgate-id
# website: your-website.com
# email: name at example.edu
# phone: "(123) 456-7890"
# image: /images/members/john-doe.jpg
---
Tell us about yourself here. You can add links like [this](https://www.google.com/search?q=this).
Open this file and edit it to your liking. Add info for whatever links you want to appear in your profile and uncommend those lines. Feel free to delete commented lines you don't want to use. If you don't want a boring default profile picture, add a SQUARE profile picture (same number of pixels wide as tall) to (in this case) /images/members/john-doe.jpg
and uncomment the image line.
To add a new blog post, type
python new_blog_post.py "My Blog Post Title"
This will create a file with a path like projects/_posts/2018-09-26-my-blog-post-title.md
. This file will look something like this:
---
layout: post
title: "My Blog Post Title"
# author:
# image: /images/blog/my-blog-post-title.png
---
Blog post content here. To see what you can do with Markdown, check out
[this Markdown cheatsheet]
(https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
Uncomment the author
line and add the name of the author. If the name matches
the name of someone with a member profile (someone with a file in
members/_posts/
), then their image will be displayed over their name in the
blog post, and a link to their profile will be generated.
If there's a header image associated with the blog post, uncomment the image
line in the file and make sure the path points to a valid image.
For that, just copy a previous event file in the events/_posts
directory. Make sure the date in the file name is the date of the event. Edit the file to your liking. Make sure to add a picture associated with the event and uncomment the image line.
If you have write access to this git repo (website admins only), then after you make changes locally you'd like the website to have, do a git add .
, git commit -m "commit message"
, and git push origin master
from within the website_source
directory. This does not save the generated source files since _site
is included in the .gitignore
file.
If you don't have write access, then fork this repo and create a pull request after you push your changes to your own repo. We'll review the changes and either accept them or work with you to clean them up.
To deploy changes to the site, first make sure you have been added as a contributor to the penndsg/website_source.git repo, then type
./deploy.sh
from within the website_source
directory. You should immediately see your changes reflected in penndsg.github.io.