HighTechU Members Projects: GitHub Repositories built by Youth.
- Jekyll (for building your website)
- GitHub Pages (for hosting your website)
- GitHub's API (for automatically populating your website with content)
If you want to manage your website in a local web development environment, you'll be using Ruby.
Clone the repository.
Jekyll is a Ruby Gem that can be installed on most systems.
- Install a full Ruby development environment
- Install Jekyll and bundler gems
gem install jekyll bundler
- Change into your new directory
cd portfolio
- Install missing gems
bundle install
- Build the site and make it available on a local server
bundle exec jekyll serve
You should see something like:
Configuration file: /octocat/personal-website/_config.yml
Source: /octocat/personal-website
Destination: /octocat/_site
Incremental build: disabled. Enable with --incremental
Generating...
GitHub Metadata: No GitHub API authentication could be found. Some fields may be missing or have incorrect data.
done in 14.729 seconds.
Auto-regeneration: enabled for '/octocat/personal-website'
Server address: http://127.0.0.1:4000
Server running... press ctrl-c to stop.
Don't worry about the "No GitHub API authentication could be found" message. API authentication is only necessary if you intend to display more detailed metadata, like a branch name.
- Now browse to http://localhost:4000
Push to the main branch, GitHub Pages will deploy the website.
This portfolio is based off the Github.dev Personal Website theme, which is available as open source under the terms of the MIT License.