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.
- macOS users should first follow Jekyll's detailed documentation to ensure proper installation of Ruby.
- If Bundler was previously installed under a different instance of Ruby, delete it with
gem uninstall bundler. - Reinstall Bundler following the Local Install subsection; if you have issues with Nokogiri, try
gem uninstall nokogiribefore 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
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.
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.
- 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
mainbranch 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".
To create a new, or modify an existing, team member profile, see the README.md in the _team/ diriectory.
To create a new, or modify an existing, news post, see the README.md in the _posts/ diriectory.
To create a new, or modify an existing, research page, see the README.md in the _research/ diriectory.
Please create issues for any problems identified with the site or requests for changes to the theme or layout.
- GitHub Docs: Working with GitHub Pages
- Jekyll: Step by Step Tutorial
- Minimal Mistakes: Quick-Start Guide