Skip to content

Latest commit

 

History

History
29 lines (15 loc) · 1.64 KB

README.md

File metadata and controls

29 lines (15 loc) · 1.64 KB

American Religious Ecologies

This repository contains the website for the American Religious Ecologies project at the Roy Rosenzweig Center for History and New Media.

Installing

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.

Bundling and visualizations

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.

Previewing

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.

Design

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.