Durham Library Civil Rights Heritage Proejct

Local Development

1. You'll need node v13.5.0. Use NVM to use this version.
2. Install theme dependencies: yarn
3. Run yarn add airtable-json --dev --ignore-engines
4. Run yarn add image-downloader --dev --ignore-engines
5. Development: yarn start The project will be available at http://localhost:8080/.

Get Most Recent Content from Airtable

1. Run yarn node ./scripts/airtable.js
2. Events will be available in app/assets/events.json and Images will be available in /app/assets/images

Content Entry for Google Doc Pages

Pages are located in /app/assets. All event pages are in event-pages.json, other pages have their own JSON file.

  {
    <!-- Page Title -->
    "name": "",
    "body": [
      <!-- Text -->
      {
        "text": ""
      },
      <!-- Unordered List -->
      {
        "ul": ["li goes here", "", ""]
      },
      <!-- Second Level Heading -->
      {
        "h2": ""
      },
      <!-- Image -->
      {
        "image": "image id goes here"
      },
      <!-- Pullquote with optional attribution -->
      {
        "pullquote":
        {
          "quote": "",
          "attribution": ""
        }
      },
    ],
    "images": [
      "additional image ids from the Event Pages airtable go here"
    ]
  }

Deployment for Staging Site

1. Push to master.

• Netlify will run yarn build (including prebuild and postbuild)
• Test site will be available at https://dlib.netlify.app/

Production

Simulating Deployment for DLIB

1. Checkout the delivery-only branch
2. Run yarn build
3. Drop the contents of ./distinto folder/exhibits/dcrhp (you'll need to create these directories)
4. Use a command line http server (such as http-server or browsersync) within the root of the folder directory to serve up static files in the browser

Creating Deliverables for DLIB

1. Checkout delivery-only
2. Run yarn build
3. Compress ./dist