mirror of the bylaws
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Vincent Batts 08053c05d8
Merge pull request #14 from zrgn/dependabot/bundler/nokogiri-1.10.8
4 months ago
_data games.json: accidentally an "i" 1 year ago
_includes Move to standard Jekyll layout. 1 year ago
_layouts Move to standard Jekyll layout. 1 year ago
_sass/vendor/bulma Use better bower/grunt integration plugin. 1 year ago
assets Use better bower/grunt integration plugin. 1 year ago
images Move to standard Jekyll layout. 1 year ago
.eslintrc.json Add eslint settings file. 1 year ago
.gitignore Ignore RVM ruby directive files. 1 year ago
404.html Move to standard Jekyll layout. 1 year ago
Gemfile Adding lots of stuff to make this an actual site driven by json data 1 year ago
Gemfile.lock Merge pull request #14 from zrgn/dependabot/bundler/nokogiri-1.10.8 4 months ago
Gruntfile.js Use better bower/grunt integration plugin. 1 year ago
LICENSE Initial commit 1 year ago
README.md Add README file. 1 year ago
_config.yml Add README file. 1 year ago
bower.json Use better bower/grunt integration plugin. 1 year ago
index.md Infraction line item 1 year ago
package-lock.json build(deps): bump eslint-utils from 1.3.1 to 1.4.3 8 months ago
package.json Use better bower/grunt integration plugin. 1 year ago
zargcon.md Add google calendar link 7 months ago

README.md

Getting Started

  • Make sure you have Ruby, Node.js, and NPM installed. You need to install nodejs-grunt-cli.
  • gem install bundler
  • bundle install
  • npm install

What is This Node.JS Stuff?

It’s a way for us to manage our asset dependencies (namely, our CSS framework and JavaScript framework). If you’re just developing content for the site, you don’t need to worry about it.

For the asset libraries, we’re using Bower which is invoked via Grunt. If you need to update the libraries, you’ll make a change to the bower.json file and change the version number. Then run grunt. The default Grunt task will wipe the old dependencies and install the new ones under assets/vendor and bower_components. The assets/vendor files can be used directly. The files under bower_components are primarily for pre-processing and should not be pulled in directly. For example, the zargon.scss file includes a bunch of the Bulma Sass so we can use their mixins and variables if we want. You’ll notice in _config.yaml that we’re telling Jekyll to place bower_components/bulma on the Sass load path.

This Seems Overly Complicated!

Yes. But apparently this is how The Internet has decided to do web development now. We could do this via a Rakefile but the only Rake integration I could find bolted a Rails-style asset pipeline onto Jekyll which is just as complicated (if not more so).

Writing Content

Create a file with a .md suffix. At the top add

---
title: My Title
layout: standard-page
---

That meta-data will tell Jekyll the title of your page and the page layout to use. Then just write your content using Markdown syntax.

Previewing the Site

Run bundle exec jekyll serve --livereload. Jekyll will render the site (into the _site directory) and start a webserver on localhost’s port 4000. You can point a browser there and get a preview of the site. As a bonus the --livereload argument will watch the directory for changes. On any change, the site will be re-rendered and Jekyll will notify your browser to refresh itself.