Master

.gitignore

@@ -1,3 +1,26 @@
 _site
+.sass-cache/
+.jekyll-metadata
+.vscode
+config-example.yaml
 *.sublime-workspace
 Gemfile.lock
+startbootstrap-*
+docs/
+venv/
+resources/HorizontalDropDownMenu/
+resources/mega-dropdown
+_layouts/bootstrap-horizontalmegamenu.html
+python/data/
+python/tmp/
+sponsor-engine/
+feed/prizes/
+_glynn.yml
+nohup.out
+*prizes.log
+*datasets.log
+*.pyc
+*.iml
+.idea
+
+google_sheets_client_secret.json

.htaccess

@@ -0,0 +1,2 @@
+Options +FollowSymlinks
+RewriteEngine on

.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+- 2.1
+script: "bundle exec jekyll build"

Gemfile

@@ -1,2 +1,7 @@
 source 'https://rubygems.org'
-gem 'github-pages'
+
+require 'json'
+require 'open-uri'
+versions = JSON.parse(open('https://pages.github.com/versions.json').read)
+
+gem 'github-pages', versions['github-pages']

README.md

@@ -1,3 +1,131 @@
 This is the source for the govhack-science website highlighing sciency datasets at [govhack-science.github.io](http://govhack-science.github.io)
 
-Content served by [Jekyll](http://jekyllrb.com/docs/), with layout and nice bits stolen shamelessly from [Rasmus Andersson](https://github.com/rsms/rsms.github.com)
+Content served by [Jekyll](http://jekyllrb.com/docs/), with layout and nice bits stolen shamelessly from [Rasmus Andersson](https://github.com/rsms/rsms.github.com)
+
+# New in 2017 ✨
+- [Google Sheets API](#google-sheets-api)
+- [Regions & Locations Loader](#regions--locations-loader)
+
+# Planning
+[GovHack Data Model](https://www.lucidchart.com/documents/view/d36186be-0c77-4e89-a735-6022a716566a)
+
+# Documentation
+- [Jekyll](https://jekyllrb.com/docs/github-pages/)
+- [Liquid Templating Engine](https://shopify.github.io/liquid/)
+- [Liquid For Designers](https://github.com/Shopify/liquid/wiki/Liquid-for-Designers)
+
+# Requirements
+- Ruby
+- RubyGems
+- NodeJS
+- Python
+- Jekyll
+
+# Installation
+https://jekyllrb.com/docs/installation/
+https://jekyllrb.com/docs/github-pages/
+
+> Our friends at GitHub have provided the github-pages gem which is used to manage Jekyll and its dependencies on GitHub Pages. Using it in your projects means that when you deploy your site to GitHub Pages, you will not be caught by unexpected differences between various versions of the gems. To use the currently-deployed version of the gem in your project, add the following to your Gemfile
+
+> The best way to install Jekyll is via RubyGems. At the terminal prompt, simply run the following command to install Jekyll:
+
+`$ gem install github-pages`
+
+All of the GitHub pages flavour of Jekyll, and its gem dependencies are automatically installed by the above command, so you won’t have to worry about them at all.
+
+
+# Run
+https://jekyllrb.com/docs/usage/
+
+`jekyll serve`
+
+If you receive a message like:
+
+> Could not find gem 'github-pages (= 67)' in any of the gem sources listed in your Gemfile or available on this machine. (Bundler::GemNotFound)
+
+Then it means GitHub has upgraded their `github-pages` gem version, so just run `bundle install` from the root directory to upgrade to the latest set of deps GitHub is using.
+
+# Python Tools
+We have a few Python tools to help us manage the ingest of data, and generating a static JSON API.
+
+To setup a virtual environment run (from the root directory):
+```
+virtualenv --system-site-packages venv
+. venv/bin/activate
+pip install -r python/requirements.txt
+```
+
+## Google Sheets API
+**In 2017, data for the portal is fetch directly from Google Sheets**
+
+You'll need to copy of the Google Sheets Client Secret before running the import scripts. If you're reading this, you most likely have access to the GOT Google Drive - the file is in `GovHack Drive 💾/Portal Data/google_sheets_client_secret.json`.
+
+Download this file to your computer, and place it in the `python` directory of this project.
+
+**ATTENTION:** do not commit this file 👍 
+
+_The first time you run one of the scripts, you will be asked to grant access to the Portal App to use your account to access to Google Sheets. Grant access or you won't be able to run any of the scripts._
+
+### Google Sheets API Config
+
+In `python/govhack_config.py` there are a few Spreadsheet IDS grabbed from Google Drive. The sheets only need to bo accessible by anyone with a GovHack Google account, no need for them to be public - even if the data in those sheets will then be made public by this site... 🔒 
+
+
+## Regions & Locations Loader
+This scripts uses a Google Sheets to create `.md` files for all regions and locations. **Any local edit to files in `pages/_jurisdictions` and `pages/_locations/*` will be lost!**
+
+To run:
+```
+. venv/bin/activate
+cd python 
+python regions_locations.py
+```
+
+## Mentors Ingest
+This script takes a `.csv` file exported from FormStack and generates a set of new .md files.
+
+To run:
+```
+. venv/bin/activate
+python python/mentors.py
+```
+
+The script tries its best to auto-populate the mentor files based on what exists in Jabberwocky (events, organisations, et cetera), but you should *still read the output of the script* to check for any `WARNINGS` you might need to fix up.
+
+
+## Prizes Ingest
+This script takes a directroy of `.csv` file downloaded from Google Drive and generates a set of new .md files.
+
+To run:
+```
+. venv/bin/activate
+python python/prizes.py
+```
+
+The script tries its best to auto-populate the prize files based on what exists in Jabberwocky (events, organisations, et cetera), but you should *still read the output of the script* to check for any `WARNINGS` you might need to fix up.
+
+
+## Datasets Ingest
+This script takes a `.csv` file exported from FormStack and generates a set of new .md files.
+
+To run:
+```
+. venv/bin/activate
+python python/datasets.py
+```
+
+The script tries its best to auto-populate the dataset files based on what exists in Jabberwocky (events, organisations, et cetera), but you should *still read the output of the script* to check for any `WARNINGS` you might need to fix up.
+
+
+## Static API
+This script *need to be run everytime we change the frontmatter of an .md* file so that we always serve the latest content to govhack.org. This generates one `.json.` file for each Markdown file thanks to the magic of [python-frontmatter](https://pypi.python.org/pypi/python-frontmatter/0.2.1).
+
+At this stage it's a straight conversion from one to the other - with no magic to compose the full entity object, include links to and from it, yet. 
+
+To run:
+```
+. venv/bin/activate
+python python/frontmatter-to-json.py
+```
+
+> Tip: If `importError: No module named yaml`, try [this SO](http://stackoverflow.com/questions/1909025/import-error-with-virtualenv). Otherwise the `virtualenv --system-site-packages venv` command should have imported the usual suspects like pyyaml.

_config.yml

@@ -0,0 +1,131 @@
+cfg:
+  has_hackerspace: false
+  current_event: gh17
+  events:
+    - gh17
+    - gh16
+    - gh15
+    - gh14
+    - gh13
+
+exclude:
+  - 2015
+  - docs
+  - python
+  - startbootstrap-agency-1.0.6
+  - startbootstrap-clean-blog-1.0.4
+  - startbootstrap-clean-blog-1.0.4-original
+  - startbootstrap-grayscale-1.0.6
+  - venv
+  - datasets
+
+collections:
+  sponsors:
+    enabled: false
+    output: true
+
+  themes:
+    enabled: false
+    output: true
+
+  datasets:
+    enabled: false
+    output: true
+
+  dataportals:
+    enabled: false
+    output: true
+
+  mentors:
+    enabled: false
+    output: true
+
+  organisations:
+    enabled: false
+    output: true
+
+  prizes:
+    enabled: false
+    output: true
+
+  jurisdictions:
+    enabled: false
+    output: true
+
+  locations:
+    enabled: true
+    output: true
+
+  handbookchapters:
+    enabled: false
+    output: true
+
+  projects:
+    enabled: false
+    output: true
+
+defaults:
+  - scope:
+      path: "_datasets"
+      type: datasets
+    values:
+      layout: dataset
+
+  - scope:
+      path: "_dataportals"
+      type: dataportals
+    values:
+      layout: dataportal
+
+  - scope:
+      path: "_mentors"
+      type: mentors
+    values:
+      layout: mentor
+      permalink: /mentors/:title.html
+
+  - scope:
+      path: "_organisations/sponsors"
+      type: organisations
+    values:
+      layout: organisation
+      permalink: /sponsors/:title.html
+
+  - scope:
+      path: "_organisations/supporters"
+      type: organisations
+    values:
+      layout: organisation
+      permalink: /supporters/:title.html
+
+  - scope:
+      path: "_prizes"
+      type: prizes
+    values:
+      layout: prize
+
+  - scope:
+      path: "_jurisdictions"
+      type: jurisdictions
+    values:
+      layout: jurisdiction
+      permalink: /regions/:title.html
+
+  - scope:
+      path: "_locations"
+      type: locations
+    values:
+      layout: location
+
+  - scope:
+      path: "_handbookchapters"
+      type: handbookchapters
+    values:
+      layout: handbook_chapter
+      permalink: /handbook/:categories/:title.html
+
+  - scope:
+      path: "_projects"
+      type: projects
+    values:
+      layout: project

_data/sponsor_config.json

@@ -0,0 +1,71 @@
+{
+    "national": {
+        "defaultColumns": 3,
+        "classes": [{
+            "slug": "lead-agency", 
+            "columns": 1.5
+        }, {
+            "slug": "lead-sponsor",
+            "columns": 1.5
+        }, {
+            "slug": "red-carpet-awards",
+            "columns": 1.5
+        }, {
+            "slug": "international-prize", 
+            "columns": 3
+        }, {
+            "slug": "platinum", 
+            "columns": 3
+        }, {
+            "slug": "gold", 
+            "columns": 3
+        }, {
+            "slug": "silver", 
+            "columns": 3
+        }, {
+            "slug": "govt-agency-supporter", 
+            "columns": 3
+        }, {
+            "slug": "supporter", 
+            "columns": 3
+        }, {
+            "slug": "foundation", 
+            "columns": 3
+        }]    
+    },
+    "state": {
+        "defaultColumns": 3,
+        "classes": [{
+            "slug": "gold-state-gov-wa", 
+            "columns": 1,
+            "classNames": "unbound"
+        }, {
+            "slug": "platinum-state-qld", 
+            "columns": 1.5
+        }, {
+            "slug": "naming-rights", 
+            "columns": 1.5
+        }, {
+            "slug": "nz-national",
+            "columns": 3
+        }, {
+            "slug": "premier", 
+            "columns": 3
+        }, {
+            "slug": "platinum", 
+            "columns": 3
+        }, {
+            "slug": "gold", 
+            "columns": 3
+        }, {
+            "slug": "silver", 
+            "columns": 3
+        }, {
+            "slug": "bronze", 
+            "columns": 3
+        }, {
+            "slug": "in-kind", 
+            "columns": 4
+        }]    
+    }
+}

_dataportals/agency/aad.md

@@ -0,0 +1,10 @@
+---
+name: Australian Antarctic Division
+gid: aad
+website_url: http://data.gov.au/organization/australianantarcticdivision
+logo_url: /resources/csiro-logo.png
+jurisdiction: australia
+type: agency-portal
+---
+
+The data portal for all Australian Antarctic Division data.