CS&S Website Archive

This website was the CS&S website through October 2022 and this repository is now archived. We've released a new website at codeforsociety.org.

---

Code for Science & Society website

Content Mangement

To update content on homepage, navigation/globals, jobs, and people, visit the CMS at https://codeforscience.org/admin/. Other pages and blog content is managed in Ghost. Project details are managed in Airtable. See details below.

To add new editors to the CMS, invite them in the identity tab of the site settings in Netlify.

Having trouble with the CMS? You can edit the data directly, its in the _data folder.

Homepage

• Blog posts marked featured in Ghost are shown on the homepage under latest news
• Other content on the homepage can be edited in the CMS under Content > Globals
• This content is stored in a JSON file in src/site/_data/globals.json.

Navigation

• Navigation is set in the CMS
• See below on how to add a new page
• This content is stored in a JSON file in src/site/_data/globals.json.

People

• Add a new person to the Collection: People
• Then they must be added to the Content > People Page to be displayed
• This content is stored in a JSON file in src/site/_data/.

Job

• Add a new job to the Collection: Jobs
• This content is stored in a JSON file in src/site/_data/.

Projects

• Managed in Airtable (CSS Main Database > Projects)
• Only displays projects in the Website data view`
• Order they show up on sponsored-projects page mirrors order on Airtable
• alumni tag is special to put projects in that section

Pages

Content for about page, project descriptions, and additional pages are managed via ghost blog at https://blog.codeforscience.org/ghost/

• Other full content pages such as "About CS&S" can also be edited in the ghost pages list.
• To add a new page, create and publish a page in Ghost. It will be available at the url specificied in ghost. It can then be added to the navigation in the CMS.
• Use the tag #no-11ty in Ghost if you create a page in ghost that should not be added to the site.

Development

This site is built on Eleventy from starters EleventyOne by philhawksworth and Eleventy Ghost.

• Eleventy with a skeleton site
• A date format filter for Nunjucks based on Luxon
• A tiny CSS pipeline with PostCSS
• A tiny inline JS pipeline
• Netlify Dev for testing Netlify redirects

Content is pulled from the local json files, managed by NetlifyCMS, and our ghost blog.

Ghost

To run the website locally, create an .env file with the following variables from the Ghost blog:

GHOST_KEY=''
GHOST_URI=''
SITE_URL=''
AIRTABLE_API_KEY=

To use your own install, edit the .env config file with your credentials. You can find your contentApiKey in the "Integrations" screen in Ghost Admin. The minimum required version for Ghost is 2.10.0 in order to use this starter without issues.

Prerequisites

• Node and NPM

Running locally

# install the dependencies
npm install

# External data sources can be stashed locally
npm run seed

# It will then be available locally for building with
npm run start

Copyright & License

Copyright (c) 2020 Code for Science and Society - Released under the MIT license.

• EleventyOne Starter Files - Copyright (c) 2020 Phil Hawksworth
• Eleventy Ghost Starter Files - Copyright (c) 2013-2020 Ghost Foundation