This repository contains the website for the American Religious Ecologies project at the Roy Rosenzweig Center for History and New Media.
The website is built using Hugo, a static site generator. Follow the installation instructions for your platform.
It also uses Node/npm for JavaScript dependencies. You will need to have those installed for your system.
Then run npm install in order to install the dependencies.
Hugo handles bundling and minification of JavaScript and CSS. Each visualization for the site gets its own directory in assets/viz/. All assets related to a visualization should go in there, including CSS. There should be a single JavaScript entry point, usually named main.js for each visualization. Those entry points should be added to the YAML header of an individual visualization's page (for example, script: viz/catholic-dioceses/main.js).
The visualizations will be compiled as a part of the build steps defined in the Makefile.
The Makefile contains rules for previewing, building, and deploying the site.
To preview the site locally, including draft and future content, run make preview.
To build for production, run make build (which will compile and minify the site) and to deploy run make deploy.
The gulpfile compiles SCSS and CSS sources from Node, as well as the project's own customizations, into a single app.css file used site-wide for the design. This is placed under the static/css directory.