Skip to content
This repository has been archived by the owner on Apr 9, 2024. It is now read-only.

hackohio/ohio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OHI/O

Build Status
Welcome to the official website for OHI/O, an organization working to foster a tech culture at the Ohio State University.

How to contribute to the homepage

The homepage is built using Jekyll - a framework for building static webpages.
https://jekyllrb.com

Installation instructions can be found here:
https://jekyllrb.com/docs/installation/

A step-by-step tutorial can be found here:
https://jekyllrb.com/docs/step-by-step/01-setup/

Markdown guide:
https://www.markdownguide.org/basic-syntax

Folder structure:
root: Contains the main HTML pages and configuration files.
_includes: Contains HTML fragments (ex. navbar, footer) that are repeatedly used across pages.
_layouts: Contains the HTML skeletons that the main content (ex. index.html, events.html) will be nested within.
_assets: Contains all project assets such as CSS, JS and images.
_site: Contains the compiled version of the homepage. (Not committed - will only show up locally after you build)

To test your code locally:

  1. Navigate to the root of the project
  2. Run bundle exec jekyll serve
  3. This will build your code (which is saved under _site) and start a local server
  4. Open your browser and go to http://localhost:4000

Remote Container setup:

If don't want to install ruby locally, and you have Docker, you can use the VS Code Remote Container. Just open the project with the Dev container and run bundle exec jekyll serve -H 0.0.0.0. (Please don't setup an EC2 instance just to work on this project)

Important files: .travis.yml: Contains the configuration for Travis CI
_config.yml: Contains the configuration for Jekyll
Gemfile: Lists all the ruby dependencies that the project needs (used for Jekyll)
deploy_rsa.enc: Encrypted key that travis uses to connect to deploy server.

Deployment thanks to Travis:
https://travis-ci.org/hackohio/ohio
https://oncletom.io/2016/travis-ssh-deploy/