Skip to content
This repository has been archived by the owner on Mar 30, 2021. It is now read-only.
/ codevid19.com Public archive

Avoid cabin fever and join participants from around the world by participating in CODEVID-19: the world's first global pandemic hackathon!

License

Notifications You must be signed in to change notification settings

devedmonton/codevid19.com

Repository files navigation

codevid19.com

Installation

We use Jeykll with Github Pages plugins so that content can be quickly published and served as a Github Page. To build locally, you'll need to install Ruby 2.1+.

With Ruby 2.1+ installed, you'll want to install dependencies using bundler.

bundle install

From this point you can build and serve the site using:

./serve.sh

This will serve the site at:

http://localhost:4000

VSCode Remote - Containers

This project is configured to work with VSCode's Remote - Containers. Be sure to follow VSCode's instructions if you are setting this up for the first time.

Our remote container includes a few pre-installed VS Code Extensions:

By default, we have set the remote container to:

  • Use Prettier as the default formatter
  • Format your files on save
  • Trim trailing whitespace from all files except Markdown

This is the easiest way to ensure your contributions meet our style guide. Check to make sure any User-level overrides do not impact your contributions.

Contributing

tl;dr: Fork and work in your own private branch. We recommend fetching and rebasing often from upstream. Submit a PR.

For more details, check out CONTRIBUTING.md.

Style Guide

This project uses Prettier to enforce a consistent code style. Ensure you have it installed and integrated with your workflow if you are doing work in HTML, SASS, JS, and/or Markdown. It's highly-recommended you have it automatically run before submitting your PRs.

Additionally, ensure line-endings pushed to origin remain LF and not forced to CRLF. For users on Windows, make sure your core.autocrlf is configured properly. For Linux/macOS users, ensure you are not forcing line endings to be CRLF.


SASS & Jekyll Interaction

Traditional SASS users may not be used to how Jekyll requires things to be laid out in your project. In short, SASS files we want Jekyll to process reside in the destination folder that the .css file should live (i.e. assets/css/main.scss and assets/css/noscript.scss). Additionally, we have to add some empty Liquid markup (the 2 lines of 3 dashes):

---
---

@import "libs/vars";
@import "libs/functions";
...

Do not remove this markup, otherwise Jekyll will not process the file into a .css file for the _site/assets/css folder. Yeah your linters may complain but it's a small price to pay.

To compile your SASS, ./serve.sh should be doing that for you already. Because of Jekyll, we do not recommend using sass CLI on its own.

About

Avoid cabin fever and join participants from around the world by participating in CODEVID-19: the world's first global pandemic hackathon!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published