scottylabs / scottylabs.github.io

The Scottylabs.org website.

The Scottylabs.org website.

This is the main website of Scotty Labs. We're using Jekyll on GitHub Pages.

Installation

Make sure you have a recent version of Ruby installed and run

$ gem install bundler
$ bundle install

If that failed, and you're on OS X, you might have to run this:

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

and then re-run bundle install.

Once you've done that, you can preview the site locally by running

$ jekyll serve

If the above doesn't work, try running

$ bundle exec jekyll serve

This will compile the static files, including all Sass assets. Then, in your browser, navigate to http://localhost:4000/ to view the generated site.

I want to...

This is a typical Jekyll project. The Jekyll documentation online is really well put together; you should give it a skim. In the mean time, here's a list of points where you might want to look:

... change the style of the site.

Since this is a Jekyll site, the repetitive content is pulled out into templates. These files are located in _includes/ and _layouts/. Altering these files will alter all files based off of them. You can tell if a file is based off another file if it includes the line layout: <something> or {% include <something> %} somewhere inside it.

To change the stylesheets, you should look in assets/css/. Here' you'll see that we're using Sass, which is a CSS preprocessor. This just means we're using a language that compiles to CSS, instead of writing CSS directly. Look it up online for more information. The main.scss file @imports the files which are located in the folder _sass/. To change the styles, you'll want to change the files located in there.

... add content to the site.

Any file or folder that doesn't start with an underscore will end up being a web page visible to users. To add content, simply create a file that doesn't have a leading underscore.

Jekyll allows you to write content using Markdown, a language that compiles to HTML. You should probably use Markdown, not HTML, to create content. For an example of how this is done, see the frontend/ folder, which contains numerous examples of using Markdown files to generate content. Feel free to use these files as starting points for generating your own content.

License

MIT License. See LICENSE. (c) 2015 ScottyLabs

scottylabs.github.io's Issues

fix footer in different reponsive sizes

when it's a single column, let the footer have a variable height

The team listing on the about page looks bad in firefox

Firefox doesn't respect %height on img elements, so the team listing looks bad. (This afternoon I made it less bad than it was before, but it still needs work.)

Our Team Listing

Our team listing needs improved content and formatting

Update "About" page for 2014-2015 year

http://scottylabs.org/about.html is out of date. Graduated members should be removed (or added to an alumni page maybe?)

This needs more photos

We need to find photos that complement the content and place them in it.

line-height on About and Events is different

If you compare the space between lines (which is what the CSS property line-height controls) for the About section and the Events section on https://scottylabs.org/, you'll notice they're significantly different. Now that you see it, you can't unsee it.

Looks like the issue is because the text for the About section is a <p> element, whereas the text for some of the other sections including Events are <h3> elements.

Font/image size

Err... why is everything so big? In the max size fluid layout, I mean. It's a little uncomfortable.

For the most part, though, everything looks really great. :) I'm up for helping with small tasks, btw.

Update Whois for 2014-2015 Year

whois scottylabs.org returns my info. @tomshen should update it to his, or an organizational contact.