-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
80 changed files
with
33,662 additions
and
33,662 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,5 @@ | ||
| /_site | ||
| /.vscode | ||
| /node_modules | ||
| /nbproject/private/ | ||
| /_site | ||
| /.vscode | ||
| /node_modules | ||
| /nbproject/private/ | ||
| /nbproject |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,69 +1,69 @@ | ||
| # Pittsburgh Lenten Fish Fry Map | ||
|
|
||
| The Pittsburgh Lenten Fish Fry Map is the brainchild of [Hollen Barmer](https://twitter.com/hollenbarmer), who has tirelessly dedicated her time since 2012 inventorying the rich array of Lenten Fish Fry events that occur every spring in Western Pennsylvania. Code for Pittsburgh helps with website development, hosting, and data maintenance! | ||
|
|
||
| ## Where Does the Fish Fry data shown on the map come from? | ||
|
|
||
| The raw data isn't here! That is by design. The map gets data from the Fish Fry API @ [fishfry.codeforpgh.com/api/fishfries](http://fishfry.codeforpgh.com/api/fishfries). Anyone can use that URL to get data to make their own fish fry map, or do things with the Fish Fry data that we haven't thought of. If you want to learn more about the database and API, head over to the [Fish Fry Form](https://github.com/CodeForPittsburgh/fishfryform) repository. | ||
|
|
||
| Occassional snapshots of the data from are being dumped into the `data` folder of this repo, but only for posterity. | ||
|
|
||
| ## Development | ||
|
|
||
| This is a static web site. We're serving it up with GitHub pages, but it can run on any web server as-is, really. | ||
|
|
||
| ### Prerequisites | ||
|
|
||
| To develop this, you have [NodeJS](https://nodejs.org/en/) installed, such that you can call `node` and `npm` from the command line. | ||
|
|
||
| Then, in the root of this directory, run: | ||
|
|
||
| `npm install` | ||
|
|
||
| This will use the `package.json` file to get and install NodeJS dependencies locally, in a `node_modules` folder. | ||
|
|
||
| You will also need these things (available on [NPM](https://www.npmjs.com)): | ||
|
|
||
| * [GulpJS](https://www.npmjs.com/package/gulp), with `gulp` callable from the command line. Install with `npm install [email protected] -g` | ||
| * [Http-Server](https://www.npmjs.com/package/http-server), with `http-server` callable from the command line. Install with: `npm install http-server -g` | ||
|
|
||
| Those two things need to be available globally. the `-g` flag in those commands makes sure of that. | ||
|
|
||
| ### Building and Watching | ||
|
|
||
| GulpJS is a task-runner that compiles and bundles source code from `src` folder into the `assets` folder. Since the deployment path for this is GitHub pages, we put things into the `assets` folder, which is where Jekyll, the software that runs GitHub pages, expects those things to be. | ||
|
|
||
| We run those tasks with `npm` scripts. | ||
|
|
||
| Running `npm run build` will compile and bundle the source code one time. | ||
|
|
||
| Running `npm run dev` will do that, plus run `http-server`, open the site in a web browser at [http://localhost:3000](http://localhost:3000), and, upon detecting changes to files in `src`, re-runs compiling/bundling and refreshes your browser. Nice! | ||
|
|
||
| If the site doesn't load after `pnpm run dev`, check [http://localhost:4000](http://localhost:4000) in your browser. This is where `http-server` lives. If you don't see anything there, make sure you can run `http-server` from the command line (see **prerequisites** above). | ||
|
|
||
| ### Where the functionality lives / where you can hack on the code | ||
|
|
||
| Most of the work is happening in `src/js/app.js`. The rest happens in `index.html`. | ||
|
|
||
| > TODO: the source code for this app is a bit of a mess...the result of quick prototyping. | ||
| ### Deploying this Site | ||
|
|
||
| Run `npm run build`, commit changes, and push as-is to GitHub to deploy. | ||
|
|
||
| ## Credits | ||
|
|
||
| The Fish Fry Map is built and maintained by members of Code for Pittsburgh. | ||
|
|
||
| It started with <a href='https://github.com/bmcbride/bootleaf'>Bootleaf</a> (which we've adapted it and modified heavily for this project), and uses <a href="http://getbootstrap.com/">Bootstrap 3</a>, <a href="http://leafletjs.com/" target="_blank">Leaflet</a>, and <a href="http://twitter.github.io/typeahead.js/" target="_blank">typeahead.js</a>, among other things. | ||
|
|
||
| ### Basemaps | ||
|
|
||
| Our nice basemaps come from all over! | ||
|
|
||
| * **Light** and **Dark** basemaps: © <a href="http://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors, © <a href="https://cartodb.com/attributions">CARTO</a> | ||
| * **Black n' Gold** basemap: Map tiles from <a href="http://stamen.com">Stamen Design</a>, under <a href="http://creativecommons.org/licenses/by/3.0">CC BY 3.0</a> license. Basemap data by <a href="http://openstreetmap.org">OpenStreetMap</a>, under <a href="http://creativecommons.org/licenses/by-sa/3.0">CC BY SA</a> license. | ||
|
|
||
| ### Icons | ||
|
|
||
| # Pittsburgh Lenten Fish Fry Map | ||
|
|
||
| The Pittsburgh Lenten Fish Fry Map is the brainchild of [Hollen Barmer](https://twitter.com/hollenbarmer), who has tirelessly dedicated her time since 2012 inventorying the rich array of Lenten Fish Fry events that occur every spring in Western Pennsylvania. Code for Pittsburgh helps with website development, hosting, and data maintenance! | ||
|
|
||
| ## Where Does the Fish Fry data shown on the map come from? | ||
|
|
||
| The raw data isn't here! That is by design. The map gets data from the Fish Fry API @ [fishfry.codeforpgh.com/api/fishfries](http://fishfry.codeforpgh.com/api/fishfries). Anyone can use that URL to get data to make their own fish fry map, or do things with the Fish Fry data that we haven't thought of. If you want to learn more about the database and API, head over to the [Fish Fry Form](https://github.com/CodeForPittsburgh/fishfryform) repository. | ||
|
|
||
| Occassional snapshots of the data from are being dumped into the `data` folder of this repo, but only for posterity. | ||
|
|
||
| ## Development | ||
|
|
||
| This is a static web site. We're serving it up with GitHub pages, but it can run on any web server as-is, really. | ||
|
|
||
| ### Prerequisites | ||
|
|
||
| To develop this, you have [NodeJS](https://nodejs.org/en/) installed, such that you can call `node` and `npm` from the command line. | ||
|
|
||
| Then, in the root of this directory, run: | ||
|
|
||
| `npm install` | ||
|
|
||
| This will use the `package.json` file to get and install NodeJS dependencies locally, in a `node_modules` folder. | ||
|
|
||
| You will also need these things (available on [NPM](https://www.npmjs.com)): | ||
|
|
||
| * [GulpJS](https://www.npmjs.com/package/gulp), with `gulp` callable from the command line. Install with `npm install [email protected] -g` | ||
| * [Http-Server](https://www.npmjs.com/package/http-server), with `http-server` callable from the command line. Install with: `npm install http-server -g` | ||
|
|
||
| Those two things need to be available globally. the `-g` flag in those commands makes sure of that. | ||
|
|
||
| ### Building and Watching | ||
|
|
||
| GulpJS is a task-runner that compiles and bundles source code from `src` folder into the `assets` folder. Since the deployment path for this is GitHub pages, we put things into the `assets` folder, which is where Jekyll, the software that runs GitHub pages, expects those things to be. | ||
|
|
||
| We run those tasks with `npm` scripts. | ||
|
|
||
| Running `npm run build` will compile and bundle the source code one time. | ||
|
|
||
| Running `npm run dev` will do that, plus run `http-server`, open the site in a web browser at [http://localhost:3000](http://localhost:3000), and, upon detecting changes to files in `src`, re-runs compiling/bundling and refreshes your browser. Nice! | ||
|
|
||
| If the site doesn't load after `pnpm run dev`, check [http://localhost:4000](http://localhost:4000) in your browser. This is where `http-server` lives. If you don't see anything there, make sure you can run `http-server` from the command line (see **prerequisites** above). | ||
|
|
||
| ### Where the functionality lives / where you can hack on the code | ||
|
|
||
| Most of the work is happening in `src/js/app.js`. The rest happens in `index.html`. | ||
|
|
||
| > TODO: the source code for this app is a bit of a mess...the result of quick prototyping. | ||
| ### Deploying this Site | ||
|
|
||
| Run `npm run build`, commit changes, and push as-is to GitHub to deploy. | ||
|
|
||
| ## Credits | ||
|
|
||
| The Fish Fry Map is built and maintained by members of Code for Pittsburgh. | ||
|
|
||
| It started with <a href='https://github.com/bmcbride/bootleaf'>Bootleaf</a> (which we've adapted it and modified heavily for this project), and uses <a href="http://getbootstrap.com/">Bootstrap 3</a>, <a href="http://leafletjs.com/" target="_blank">Leaflet</a>, and <a href="http://twitter.github.io/typeahead.js/" target="_blank">typeahead.js</a>, among other things. | ||
|
|
||
| ### Basemaps | ||
|
|
||
| Our nice basemaps come from all over! | ||
|
|
||
| * **Light** and **Dark** basemaps: © <a href="http://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors, © <a href="https://cartodb.com/attributions">CARTO</a> | ||
| * **Black n' Gold** basemap: Map tiles from <a href="http://stamen.com">Stamen Design</a>, under <a href="http://creativecommons.org/licenses/by/3.0">CC BY 3.0</a> license. Basemap data by <a href="http://openstreetmap.org">OpenStreetMap</a>, under <a href="http://creativecommons.org/licenses/by-sa/3.0">CC BY SA</a> license. | ||
|
|
||
| ### Icons | ||
|
|
||
| Church and Warehouse icons come from © Mapbox. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,7 +1,7 @@ | ||
| exclude: [ | ||
| 'node_modules', | ||
| 'src', | ||
| 'gulpfile.js', | ||
| 'package-lock.json', | ||
| 'package.json' | ||
| exclude: [ | ||
| 'node_modules', | ||
| 'src', | ||
| 'gulpfile.js', | ||
| 'package-lock.json', | ||
| 'package.json' | ||
| ] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,5 @@ | ||
| # assets | ||
|
|
||
| Compiled and bundled `js` and `css` files, plus static file assets in `data/` and `img/`. | ||
|
|
||
| Don't edit the `js` and `css` files here, edit the source files in the `src/` folder. | ||
| # assets | ||
|
|
||
| Compiled and bundled `js` and `css` files, plus static file assets in `data/` and `img/`. | ||
|
|
||
| Don't edit the `js` and `css` files here, edit the source files in the `src/` folder. |
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
Oops, something went wrong.