This repository is the container web site for https://evictionlab.org.
Clone this repo and run locally using Hugo v0.101.
hugo server -D
Note: use the
-D
flag to ensure that pages marked as "draft" are generated for development purposes. Draft pages will not be included in the staging / production build, but will be included on any Netlify builds.
Follow this branching flow when adding features or changes to the website:
development
, named relative to what you're working on.
development
branch
development
branchdevelopment
branch are ready to be deployed to the live site, merge development
into staging
staging
to production
When making content updates, use the CMS or use the following flow:
staging
branch, named accordingly.staging
staging
into production
development
branch.The following data files are consumed by the eviction-lab repo to populate data in the /eviction-tracking page (rendered by its el-site app): site_metadata.csv, filing_data_by_site.csv, main_landing_page_data.csv, and main_landing_page_demographics.csv.
In order to keep /eviction-tracking up to date when data is updated here, this repo has Rebuild Landing Page actions that trigger rebuilds of the development, staging, and production sites of the eviction-lab repo when a commit is pushed to the corresponding branch of this repo.
The template is based on small, content-agnostic partials that can be mixed and matched. The pre-built pages showcase just a few of the possible combinations. Refer to the site/layouts/partials
folder for all available partials.
Use Hugo’s dict
functionality to feed content into partials and avoid repeating yourself and creating discrepancies.
The template uses a custom fork of Tachyons and PostCSS with cssnext and cssnano. To customize the template for your brand, refer to src/css/imports/_variables.css
where most of the important global variables like colors and spacing are stored.