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

• Ruby
• Jekyll (gem install jekyll)
• Bundler (gem install bundler)

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

• To contribute to the website, you must first fork this repo, then commit changes to your fork (see subsection topics below), before making a pull request (see our GitHub wiki guide for basic information and additional resources).
• Periodically, and especially before you start making any local changes (to avoid merge conflicts), we recommend synchronizing your branch to fetch the latest changes made to this main repo (the upstream branch to your personal fork); see Syncing your branch on our wiki or Syncing a fork at GitHub Docs.
• You should make and verify (by viewing locally) changes to the main branch of your fork and make a pull request from your head repository: username/UNLV-SPFG.github.io, compare: main to our base repository: UNLV-SPFG/UNLV-SPFG.github.io, base: main (see Creating a pull request from a fork for more information).
• If you're new to Jekyll, we strongly recommend following their < 30-minute Step by Step Tutorial to understand its core structure and basics.
• For theme independent changes to the site's content or structure, see Jekyll's Docs by relevant topic.
• This site uses Minimal Mistakes as its theme. See the relevant pages under "Customization" to make modifications. Similarly, for theme dependent content changes, see the relevant pages under "Content".

Team

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

News

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

Research

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

Issues & Requests

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

Sources

• GitHub Docs: Working with GitHub Pages
• Jekyll: Step by Step Tutorial
• Minimal Mistakes: Quick-Start Guide