LASP-UCL/lasp-ucl.github.io

LASP-UCL website

LASP Website

LASP website using Hugo and HugoBlox Academic Group Theme for github-pages.

1. Setup an environment

Create an environment using GitHub Codespaces (recommended)

GitHub Codespaces provides a cloud-powered Visual Studio Code environment for any GitHub project. You can set up one at project page by clicking code and then create codespace on main, as below.

Create an environment at your local machine

• Install Hugo Extended (non-extended will fail), see here.
• Install python (required by update_publication.sh), see here
• Choose and download a code editor, such Visual Studio Code

2. Build and preview

After setting up an environment, you should run the update_publication.sh script to populate publications and then use the hugo server to preview the website, as below.

sh scripts/update_publication.sh # only once
hugo server

3. Deploy

The deployment to http://lasp-ucl.github.io is done by a GitHub workflow. It is trigged automatically after push changes to GitHub.

See deployment logs (and possible fails) at the project actions.

References of other websites using HugoBlox Academic Group Theme

• https://github.com/logconference/logconference.github.io
• https://github.com/tsl-imperial/tsl-website
• https://github.com/SPS-L/sps-cut
• https://github.com/2i2c-org/2i2c-org.github.io
• https://github.com/mickaellalande/mickaellalande.github.io