hms-dbmi / gehlenborglab-website

Code for Gehlenborg Lab website.

Home Page:http://gehlenborglab.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

gehlenborglab-website Build Status

Looking for website updating instructions?

(Need to set up your own Jekyll/S3 site? See generate-static-site.)

The HIDIVE Lab website uses Jekyll plugins beyond those supported by GitHub Pages. Instead, when the main branch is updated, Github Actions builds _site and pushes it to the appropriate S3 bucket. You will need to need to have a working, up-to-date ruby environment.

Install rvm [https://rvm.io/rvm/install]. RVM should load or prompt for installation of the ruby version in .ruby_version on entry to the project folder.

With Ruby fixed, then:

$ gem install bundler
$ bundle install
$ npm install
$ jekyll serve &

When Jekyll is watching the filesystem, it won't run post-processing hooks that generate thumbnails. You can do this manually:

brew install imagemagick
./post-build.sh

Workflow

For smaller edits, you can just use the editor on the github site, though it's still a good idea to save the edit to a branch.

For larger edits, check out this repo locally. Our convention for branch names is username/description, so it's easy to tell whose contribution it is. Run jekyll locally to get a preview of the site.

Troubleshooting

If using OS X >=10.12 you may run into errors installing nokogiri with the bundle install step. This workaround should do the trick:

sudo gem install nokogiri -v '1.6.8.1' -- --with-xml2-include=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.12.sdk/usr/include/libxml2 --use-system-libraries

About

Code for Gehlenborg Lab website.

http://gehlenborglab.org

License:MIT License


Languages

Language:HTML 72.9%Language:SCSS 21.8%Language:Ruby 3.5%Language:Shell 1.8%