NolanChan / site

This is a website with a map of food sources in Los Angeles, and list of resources about food deserts and health, published with Jekyll and GitHub Pages.

Food Oasis

This is a website with a map of food sources in Los Angeles, and list of resources about food deserts and health. You can view the site here… https://foodoasis.la

How to make changes

The website is published with GitHub Pages, and the files are generated with Jekyll.

As you make changes and commit/push them to GitHub, the website will automatically update.

How to develop locally

If you want to see a preview of your changes before they appear on the live site, you can run a Jekyll server on your local machine. Installing Ruby and Jekyll is a good place to start.

A summary of the project files

Files for Jekyll

_config.yml
_data/*
_drafts/*
_includes/*
_layouts/*

Files for Node.js

_node/*

Files generated by Node.js, for Jekyll

_community-garden/*
_farmers-market/*
_food-pantry/*

Files for GitHub

README.md
LICENSE
CNAME

Assets

assets/css
assets/images
assets/js

Third-party assets

assets/leaflet

Pages

index.html
organizations.md
resources.md
about.md
team.md
faqs.md
news.html
404.md

Pages translated into Spanish

es/*

Map

map.html

Lists

list.html
community-garden.html
farmers-market.html
food-pantry.html

How to update the food source data

The food sources listed on the website are generated by Jekyll, from markdown files in these folders…

_community-garden/*
_farmers-market/*
_food-pantry/*

The markdown files themselves are generated by Node.js from the data files in the _data folder.

To re-generate the files, first install Node.js. And then run these three commands from your project folder…

1. Change to the _node directory…

cd _node

2. Install Node.js dependencies for this project…

npm install

3. Ask Node.js to run the generation script

node generate-locations.js

Note that this will overwrite the existing markdown files, but it won’t remove any of them. You may wish to manually remove these three folders before running generate-locations.js, so there won’t be any old files left inside them…

_community-garden/*
_farmers-market/*
_food-pantry/*