Skip to content
HTML Ruby CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
_data
_includes
_layouts
_posts
assets
favicon Add a sharing metadata image Oct 29, 2019
feeds
fonts
images LincolnHack blog post Oct 8, 2019
repo-images
.gitignore
.ruby-version
404.html Base template for website Sep 30, 2018
CODE_OF_CONDUCT.md create CODE_OF_CONDUCT.md Oct 31, 2018
Gemfile
Gemfile.lock reset lock file Oct 3, 2019
LICENSE.md
README.md Add link to license on tldrlegal Oct 11, 2018
_config.yml add events ical (for when events exist in site data) Oct 31, 2019
about.md Add contributing link Oct 2, 2018
contributing.md Edit contributing.md to include instructions for adding author details Oct 3, 2018
contributors.md
docker-compose.yml Fixed Issue 62 Bundler Version Out of Date Oct 6, 2019
events.md
favicon.ico
home.md
index.md

README.md

Hacktoberfest Website

This website is a community website for everyone to be able to contribute to. Tech should be accessible to everyone and everyone should be included in the making of it. This site aims to help break down barriers and allow people to contribute to a project with whatever skills they have.

How to contribute

You can contribute through the browser or from your favourite terminal. Go the contributing guide to learn how.

About our license

All content in this repository is licensed under a Creative Commons license, specifically CC BY-NC-SA 4.0.

This means you can:

  • Share it in any format or medium
  • Adapt it by changing or building upon it

As long as you:

  • Attribute your adaptation to their original creator(s).
  • Don't use any of the material commercially.
  • Distribute any changes you make under the same license.
  • Don't add any additional restrictions outside of what the license already disallows.

You can find some more information about the license here.

Getting The Site Running

The site is built using Jekyll, a Ruby application, or Gem.

As such, you'll need a way to run Jekyll, to build and serve the site while you work on it.

The options for this are as follows:

  • Run Jekyll in Docker
  • Run Jekyll on your local machine

The sections below cover these options.

Run Jekyll in Docker

You'll need to install Docker on your operating system.

ℹ️ Ensure when you install that you are using Linux containers, not Windows ones (even if you're installing on Windows).

Once docker is installed, simply go to the root of the project folder in a terminal window, and run:

docker-compose up

The local site can be reached here: http://localhost:4000/

It will respond automatically to changes you make to the source; just refresh the page in the browser to see changes.

Well done, you're up and running! 🎉

Run Jekyll Locally

you'll need Ruby installed (version 2.3.3 or newer).

This guide does include steps for installing Ruby, and other Jekyll dependencies, but you can always refer to Jekyll's own guide here.

Installing Ruby and other dependencies

Windows (native)

To install Ruby on Windows, you can

  • Use Chocolatey (a Windows Package Manager)
    1. Get Chocolatey
    2. Open Command Prompt or Powershell
    3. > choco install ruby -y
  • Download it from RubyInstaller
    1. Download Ruby + Devkit
    2. Run the installer

Mac OS X

OS X comes with many open source packages pre-installed, including Ruby. To check your version of ruby, open a terminal and run $ ruby -v

You should get some output like this, denoting version 2.3.7:

ruby 2.3.7p456 (2018-03-28 revision 63024) [universal.x86_64-darwin17]

If your version is 2.3.3 or greater, you do not need to install ruby; you can move on to Instaling Jekyll.

Otherwise, you will need to upgrade ruby. The easiest way is to use rvm. In the terminal, run the following commands:

  • $ curl -sSL https://get.rvm.io | bash -s stable --ruby
  • $ rvm install 2.3
  • $ rvm use 2.3 --default

Restart your terminal and check the ruby version using > ruby -v

Linux / Windows Subsystem for Linux

For Ubuntu / Debian-based distributions:

$ sudo apt install ruby ruby-dev build-essential -y

Installing Jekyll

Now that Ruby is installed, installing Jekyll (and other gems) should be platform agnostic.

  • ℹ️ you may need to run commands prefixed by sudo on non-Windows environments.
  • ℹ️ You may need to logout / restart your terminal window to refresh paths.

Install Jekyll as follows, from a terminal window:

gem install jekyll bundler

Install site dependencies

To ensure the site has any other gems it depends on installed, make sure you're in the project folder root and run:

bundle update

Running the site

Now that everything is set up, you can run the site locally.

  1. Make sure you're in the project folder root and run:
    • jekyll serve.
  2. Leave that terminal window open
  3. Head to your favourite web browser

The local site can be reached here: http://localhost:4000/

Well done, you're up and running! 🎉

Instructions not clear?

Raise a pull request with your changes!

You can’t perform that action at this time.