SASIP Website Source

Visit the resulting website here : https://sasip-climate.github.io

This repo contains the source code for the SASIP website. The site uses the Hugo framework. The source files are written in markdown. A GitHub workflow is configured to automatically build and deploy the website to https://sasip-climate.github.io/ whenever the master branch of this repo is updated.

Instructions for updating this site

To update the site, you need to change the source files on the master branch of this repository. There are two ways to do this.

Easy Way: Edit on GitHub

You can edit the source files directly on GitHub from your browser. To do this, navigate to the content folder and click the edit button (little pencil symbol). Make your changes in the editor. When you are done, you can either "Commit directly to the master branch" or "Create a new branch for this commit and start a pull request". A direct commit is appropriate for a minor change. A pull request is best if you want your changes to be reviewed and approved by the rest of the team. This method only allows you to update one page at a time.

More specifically

• If you want to modify informations on people (https://sasip-climate.github.io/team/) :

  • modify or duplicate a md file in https://github.com/sasip-climate/sasip-climate.github.io/tree/master/content/team

  • modify :

    • title : First Name Last Name
    • image : 'images/team/namefilephoto'
    • jobtitle : Job Title
    • weight : the rank at which the person must appear on the team page (after the WP leaders and managers, the order is alphabetical, see this doc to get the rank and reorder the list when adding a new person)
    • after the --- Name of the Institution then *keywords, separated, by commas*

  • upload the photo in static/images/team

• If you want to modify the description of a work package (https://sasip-climate.github.io/research/) :

  • modify the corresponding md file in https://github.com/sasip-climate/sasip-climate.github.io/tree/master/content/research

• If you want to add a job position (https://sasip-climate.github.io/jobs/) :

  • create a md file that will look like https://github.com/sasip-climate/sasip-climate.github.io/blob/master/content/jobs/ponts.md, it will be added automatically to the list

• If you want to add a new paper in our "Publications" list related to the project, just edit the markdown file here: https://github.com/sasip-climate/sasip-climate.github.io/blob/master/content/pages/publications/index.md

After every modifications, have a look at https://github.com/sasip-climate/sasip-climate.github.io/actions to see if the workflow is complete (some extra time is needed for the modifications to appear on the website), we want a green light !

Hard Way: Edit Locally

You can also clone this repository, make local changes, and then push them. This is better for larger changes that involve multiple files and may need debugging.

Basic git workflow

git clone [email protected]:sasip-climate/sasip-climate.github.io.git
cd sasip-climate.github.io
# edit files with your text editor
git add [new or modified files]
git commit -m '<your commit message>'
git push origin master

You can also build the website locally on your own computer. This can be useful for debugging. To do this, you need to first Install Hugo. Then inside the repository launch hugothen hugo server and you can look at the website locally at localhost:1313

For the moment, we want a particular version of hgo, the 0.92.0, otherwise our website fails. to get it with brew on mac do these steps :

 brew install hugo
 brew uninstal hugo
 curl https://raw.githubusercontent.com/Homebrew/homebrew-core/cb7b2c8709b7c4842f705b745b7cac591629f6be/Formula/hugo.rb > $(find $(brew --repository) -name hugo.rb)
 brew install hugo

(following the steps described here

a nicer way of doing it is (but doesn't always complete ...) :

brew extract --version=0.92.0 hugo homebrew/cask
brew install [email protected]