Skip to content

UNLV-SPFG/UNLV-SPFG.github.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UNLV Star & Planet Group Homepage

Viewing Site Locally

You can clone this repo and build the GitHub Pages site locally to preview and test any changes, as it can take up to 20 minutes to publish commits to the site after pushing to GitHub.

Prerequisites

Jekyll on macOS

  1. macOS users should first follow Jekyll's detailed documentation to ensure proper installation of Ruby.
  2. If Bundler was previously installed under a different instance of Ruby, delete it with gem uninstall bundler.
  3. Reinstall Bundler following the Local Install subsection; if you have issues with Nokogiri, try gem uninstall nokogiri before installing Bundler (it will fetch the correct version of Nokogiri).

Once the prerequisites have been installed, run the following command in the root of your cloned repo (.../UNLV-SPFG.github.io/):

bundle install

Build

Jekyll is a static site generator, so we need it to build the site before we can view it. You can run the following command in the root of your local repo to both build and serve it locally:

bundle exec jekyll serve

This will run a local web server that you can view at http://localhost:4000 with your browser.

Conversion error (Jekyll >= 3.7.3)

If you encounter the following error when attempting to build

Conversion error: Jekyll::Converters::Scss encountered an error while converting 'assets/css/main.scss':
                    Invalid US-ASCII character "\xE2" on line 54

Try this fix. Skim the rest of the output after the above error message for lines similar to the following

    from /home/$USER/gems/gems/sass-3.7.4/lib/sass/util.rb:1090:in `rescue in block in find_encoding_error'

to help locate the path to your .../gems/sass-3.7.4/lib/sass/engine.rb. Please open an issue if you need help or still encounter errors.

Making Changes

Team

To create a new, or modify an existing, team member profile, see the README.md in the _team/ diriectory.

News

To create a new, or modify an existing, news post, see the README.md in the _posts/ diriectory.

Research

To create a new, or modify an existing, research page, see the README.md in the _research/ diriectory.

Issues & Requests

Please create issues for any problems identified with the site or requests for changes to the theme or layout.

Sources