Skip to content

Digital Humanities and the Climate Toolkit (draft), Digital Humanities Climate Coalition (DHCC)

Notifications You must be signed in to change notification settings

SAS-DHRH/dhcc-toolkit

Repository files navigation

Digital Humanities and the Climate Toolkit (draft)

Access the tool-kit on github pages at https://sas-dhrh.github.io/dhcc-toolkit/.

Editing content

Edit the markdown files in the ./content folder, commit your changes to the repository, then visit the Publish to Github pages action and manually run the workflow to publish changes.

The site theme is configured to generate last modified date and edit links in the footer of every page, making it easier to link back to and directly edit the markdown files in the github repository.

Software requirements

We have tried to use minimal software dependencies, a lightweight theme with simple HTML/CSS and github's own actions as the site's hosting infrastructure.

This site uses the Hugo CMS, the hugo-book theme, and github actions to build and publish the site on GitHub pages.

The hugo site configuration is in the config.yaml file. This contains theme specific parameters and some general hugo configuration settings.

The repository is configed to serve the site from the gh-pages branch of the repository, and the actions are configured in the .github/workflows/main.yml file to build and commit HTML output to that branch.

The main action must be triggered manually. This is to control/minimise the amount of devops actions container setup time the site uses.

The github action depends on 3 external actions from the Github marketplace: the github checkout action to checkout the repo into the action's temporary container, peaceiris' hugo actions to install hugo and build the site inside the container, and peaceiris' github pages actions to put the built HTML content into the gh-pages branch of the repository where it can be hosted publically online.

Digital Humanities Climate Coalition (DHCC)

The Digital Humanities Climate Coalition is a collaborative and cross-institutional initiative focused on understanding and minimising the environmental impact of DH research. Participants are based at HE institutions and DH Centres across the UK, Ireland, and Northern Europe.