This repository contains a Hugo template to create a personal academic website. The template uses the PaperMod theme but modifies it in various ways to be more minimalist and more adapted to academic websites. The website is hosted on GitHub Pages.
The template is documented at https://pascalmichaillat.org/d5/.
The website produced by the template can be viewed at https://pascalmichaillat.org/hugo-website/.
- Clone the repository to your local machine
- Install Hugo. On a Mac, this is easily done with Homebrew: simply run
brew install hugo
in the terminal. - Since the website is hosted on GitHub Pages, it is convenient to install GitHub Desktop. The website can conveniently be updated from your local machine via GitHub Desktop without going to GitHub.
- Update the
baseURL
parameter inconfig.yml
with the website URL that you plan to use. By default the ULR ishttps://username.github.io
.
- The first time that you push your repository to GitHub, you need to allow GitHub Actions and GitHub Pages so the website can be built and deployed to GitHub Pages.
- The first step is to ask GitHub to publish the website with a GitHub Action. GitHub offers a ready-made action to publish a Hugo website, called
Deploy Hugo site to Pages
. This action must be enabled in the Pages Settings of your GitHub repository. You can view the workflow triggered by the action in the.github/workflows/hugo.yml
file. - Once the GitHub Actions are enabled, GitHub will build and publish the website as soon as the repository is updated.
Navigate to the website directory and run hugo server
in the terminal. The command builds the website on your machine and makes it available at http://localhost:1313. You can modify the content of the repository and develop your website entirely on your local machine.
Once your website is ready to be made public, run hugo
in the terminal from the website directory. When you run the hugo
command, Hugo processes your content, templates, and other project files and generates a static website. The resulting output is placed in the public
folder.
With GitHub Desktop, commit the changes and push them to the website repository on GitHub. Then, GitHub Actions build the website and deploy it to GitHub Pages.
Despite the modifications to the PaperMod theme, the website continues to perform well on mobile and desktop devices. Here is an overview of the mobile performance from PageSpeed Insights:
![mobile](https://private-user-images.githubusercontent.com/85443660/284024046-1488df3e-19bb-4f9f-8a86-11f361414d92.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQwOTk3NzEsIm5iZiI6MTcyNDA5OTQ3MSwicGF0aCI6Ii84NTQ0MzY2MC8yODQwMjQwNDYtMTQ4OGRmM2UtMTliYi00ZjlmLThhODYtMTFmMzYxNDE0ZDkyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE5VDIwMzExMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTQyOTk3NTM1ZDgzYjhmZTJkMDJjY2I2OTA2ZDhjYTFlZjk0OTdhODY1MzczN2ZhNjc5NWQ3YjEyMjkyOGQ3MDQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.avYD3CAZvws1XKhImVTujd6LmSuAmm_6vPMaHw7vKx4)
And here is an overview of the desktop performance:
![desktop](https://private-user-images.githubusercontent.com/85443660/266507467-eff134d2-6097-4bc2-bfd7-4f5c18571789.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQwOTk3NzEsIm5iZiI6MTcyNDA5OTQ3MSwicGF0aCI6Ii84NTQ0MzY2MC8yNjY1MDc0NjctZWZmMTM0ZDItNjA5Ny00YmMyLWJmZDctNGY1YzE4NTcxNzg5LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE5VDIwMzExMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTk3NWY4NDg3ZmFhZjgwYzcxMWZhMzZkZGVhNWRlNjFjYmZiNTJjZDhkNzYwYmY4ZjY5MGNjZmFlZWM1ZjZiNTcmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.TQXNYbXN4xf7rsXi0Uw1vJKHLCLKwrmnjAhP6ufuPf4)
The website was built with Hugo v0.124.1 on an Apple Silicon Mac running macOS Sonoma 14.4.1.
The content of this repository is licensed under the terms of the MIT License.
- Pascal Michaillat's website (source code)
- Dylan Balla-Elliott's website (source code)
- Rosa van den Ende's website (source code)
- Samia Kabir's website (source code)
- Dylan Laplace Mermoud's website (source code)
- Maarten Goos's website (source code)
- Aryan Ahadinia's website (source code)
- Jun Wong's website (source code)
- Erling Rennemo Jellum's website (source code)
- Yangkeun Yun's website (source code)
- Maghfira Ramadhani's website (source code)
- Ismael Moreno-Martinez's website (source code)
- Lucas Warwar's website (source code)
- Franz Louis Cesista's website (source code)
- Pragathi Praveena's website
- Qiwei He's website
- Pierre Bardier's website