A website that allows students (high school and adult) and those who support them (parents, guidance counselors) to not only search among colleges to find schools that would meet their desires, but also encourage them to consider "value" factors, be exposed to schools with better outcomes, and allow users to compare and contrast schools across different dimensions of "fit," highlighting "value" factors. The goal is to enable people to find schools that are best suited to them, and ensure a broad and flexible definition of elements that contribute to "fit."
This repo contains the front end of a web app with its API created by an instance of Open Data Maker which is configured with a specific data set. For more details on setting up the back end of the web app, see below: Running the API Locally. However, you can run the web app with the hosted API following the installation instructions in the next section.
This site is made with Jekyll. Once you've got Ruby on your computer, you can run:
gem install github-pages(Note: depending on how Ruby was installed, you may need to prefix the above
command with sudo.)
This Jekyll site features dynamic Javascript that queries api.data.gov. For the Javascript to work, it needs an
API key and a base URL. Jekyll will pull them from the local machine's
environment variables at build time, so ensure that both the API_KEY and
API_BASE_URL variables are set before running build scripts.
To start up the local server, run:
jekyll serve --baseurl='' -wThen visit http://localhost:4000 to view it. The -w
(or --watch) flag tells Jekyll to rebuild the relevant pages when you edit
the source files.
- Styles: we're using Sass, which is bundled with Jekyll.
- Font: Montserrat hosted on Google Fonts.
- Charts will be rendered with D3.
To set up the API (as a developer), follow the Open Data Maker installation instructions then:
- download the full data set into open-data-maker directory and rename the folder as "real-data"
- set DATA_PATH environment variable. On the command line:
export DATA_PATH=./real-data
- This application uses only most recent data. To speed up start up time, edit
data.yamlfile inside thereal-datadirectory to limit the number of files indexed to 4 (year 2013 is included twice, once for the columns that are not specific to any year, and once for the 2013 data, then 2012 and 2011). Optionally, limiting the number of rows will reduce the set of colleges in the data set and is helpful for testing since it speeds startup time significantly:
options:
limit_files: 4
limit_rows: 100
To create the API for the complete set of schools, comment out the limit_rows option by adding a # to the start of the line:
options:
limit_files: 4
# limit_rows: 100
- Start Open Data Maker. On the command line, from the open-data-maker directory:
padrino start
- To view progress of indexing, it is helpful to look at the development log in another terminal window:
tail -f log/development.log