(instructions modified from https://github.com/academicpages/academicpages.github.io)
-
Clone this repository.
-
Make sure that rvm, ruby-dev, ruby-bundler, and nodejs are installed. If you get errors when trying to run the commands below, try updating these packages (especially rvm and bundler) to the latest versions.
- Note: If installing RVM for the first time, follow the instructions at https://rvm.io/rvm/install. If installing on Ubuntu, the custom Ubuntu package linked in the instructions may not work; instead, follow the instructions under "Any other system".)
-
Run the following commands to initialize the site configuration:
bundle clean(no need to run --force)bundle install(to install ruby dependencies; if you get errors, delete Gemfile.lock and try again)
-
Run the following to start RVM and thus use the correct Bundler version (substituting your username for [USERNAME], and changing the directory if rvm was installed in another location):
source /home/[USERNAME]/.rvm/scripts/rvm -
Start the server:
bundle exec jekyll serve -
The website will be visible at http://localhost:4000/.
Click Use this template button above for the quickest method of getting started with the Minimal Mistakes Jekyll theme.
Contains basic configuration to get you a site with:
- Sample posts.
- Sample top navigation.
- Sample author sidebar with social links.
- Sample footer links.
- Paginated home page.
- Archive pages for posts grouped by year, category, and tag.
- Sample about page.
- Sample 404 page.
- Site wide search.
Replace sample content with your own and configure as necessary.
If you have a question about using Jekyll, start a discussion on the Jekyll Forum or StackOverflow. Other resources:
- Ruby 101
- Setting up a Jekyll site with GitHub Pages
- Configuring GitHub Metadata to work properly when developing locally and avoid
No GitHub API authentication could be found. Some fields may be missing or have incorrect data.warnings.