Initial commit

Author: grivetti

.github/workflows/hugo.yml

@@ -0,0 +1,74 @@
+# Sample workflow for building and deploying a Hugo site to GitHub Pages
+name: Deploy Hugo site to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+# Default to bash
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    env:
+      HUGO_VERSION: 0.147.2
+    steps:
+      - name: Install Hugo CLI
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+      - name: Install Dart Sass
+        run: sudo snap install dart-sass
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Install Node.js dependencies
+        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
+      - name: Build with Hugo
+        env:
+          HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
+          HUGO_ENVIRONMENT: production
+        run: |
+          hugo \
+            --minify \
+            --baseURL "${{ steps.pages.outputs.base_url }}/"
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./public
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,4 @@
+# Hugo build artifacts
+public/
+resources/
+.hugo_build.lock

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023–present Pascal Michaillat  
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,110 @@
+# Minimalist Hugo Template for Academic Websites
+
+This repository contains a [Hugo](https://github.com/gohugoio/hugo) template to create a personal academic website. The template uses the [PaperMod theme](https://github.com/adityatelange/hugo-PaperMod) but modifies it in various ways to be more minimalist and better suited for academic websites. The website is hosted on [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages).
+
+## Documentation
+
+The template is documented at https://pascalmichaillat.org/b/.
+
+## Illustration
+
+The website produced by the template can be viewed at https://pascalmichaillat.org/hugo-website/.
+
+## Installation
+
+### On your local machine
+
++ Install [Hugo](https://gohugo.io/installation/). On a Mac, this can be done with [Homebrew](https://brew.sh): run `brew install hugo` in the terminal. If you already have Hugo but it is outdated, run `brew upgrade hugo`.
++ Since the website is hosted on GitHub Pages, it is convenient to install [GitHub Desktop](https://desktop.github.com). The website can be updated from your local machine via GitHub Desktop without going to GitHub.
++ Clone the template repository to your local machine. This can be done in two steps:
+	1. Click "Use this template" and then "Create a new repository" at the top of the repository.
+	2. Once the new repository is created on your GitHub account, open GitHub Desktop and click "File" and then "Clone repository". Find the newly created repository under the "GitHub.com" tab and clone it.
++ Update the `baseURL` parameter in `config.yml` with the website URL that you plan to use. By default the URL is `https://username.github.io`.
+
+### On your GitHub account
+
++ 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](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow). 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](https://github.com/pmichaillat/hugo-website/settings/pages) 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. 
++ If you would like to update the deployment action (for instance because it became outdated and fails to deploy the site), you can find the [most recent action on GitHub]( https://github.com/actions/starter-workflows/blob/main/pages/hugo.yml). You can place this file directly in the `.github/workflows` folder to replace the old `hugo.yml` file—but make sure to set `push: branches` to `["main"]`.
+
+## Usage
+
+### Local development
+
+Navigate to the website directory (`cd`) and run in the terminal:
+
+```bash
+hugo server
+```
+
+The command builds the website on your machine and makes it available at http://localhost:1313, rebuilding automatically as you edit. You can modify the content of the repository and develop your website entirely on your machine.
+
+### Online deployment
+
+Once your website is ready to be made public, commit your content and template changes and push them to the website repository on GitHub. It is convenient to use GitHub Desktop for this Git operation.
+
+On each push, the [GitHub Actions workflow](https://github.com/pmichaillat/hugo-website/actions/workflows/hugo.yml) invokes Hugo to generate the website and deploys the output to [GitHub Pages](https://github.com/pmichaillat/hugo-website/deployments/github-pages). During the workflow, Hugo processes your content, templates, and other project files and generates a static website.
+
+## Performance
+
+The website performs well on mobile and desktop devices. Here is an overview of the mobile performance from [PageSpeed Insights](https://pagespeed.web.dev/):
+
+<img width="470" alt="mobile" src="https://github.com/pmichaillat/hugo-website/assets/85443660/1488df3e-19bb-4f9f-8a86-11f361414d92">
+
+And here is an overview of the desktop performance:
+
+<img width="453" alt="desktop" src="https://github.com/pmichaillat/pmichaillat.github.io/assets/85443660/eff134d2-6097-4bc2-bfd7-4f5c18571789">
+
+## Software
+
++ The website is built with Hugo v0.147.2 via GitHub Actions.
++ The website was developed locally with Hugo v0.147.2 on macOS Sequoia. 
++ The website was tested on the following browsers:
+	+ Safari 18.4 on macOS Sequoia
+	+ Mobile Safari on iOS 18  
++ Other Hugo versions, operating systems, and web browsers may require minor adjustments. Please [report any issues](https://github.com/pmichaillat/hugo-website/issues) to help improve compatibility.
+
+## License
+
+This repository is licensed under the [MIT License](LICENSE.md).
+
+
+## Real-world implementations
+
++ [Pascal Michaillat's website](https://pascalmichaillat.org/) ([source code](https://github.com/pmichaillat/pmichaillat.github.io))
++ [Rosa van den Ende's website](https://rosavandenende.github.io) ([source code](https://github.com/rosavandenende/rosavandenende.github.io))
++ [Samia Kabir's website](https://samiakabir.com) ([source code](https://github.com/SamiaKabir/samiakabir.github.io))
++ [Dylan Laplace Mermoud's website](https://dylanlaplacemermoud.github.io) ([source code](https://github.com/DylanLaplaceMermoud/dylanlaplacemermoud.github.io))
++ [Maarten Goos's website](https://maartengoos.com) ([source code](https://github.com/MaartenGoos/website))
++ [Jun Wong's website](https://junwong.org) ([source code](https://github.com/junwong97/junwong97.github.io))
++ [Erling Rennemo Jellum's website](https://erlingrj.github.io) ([source code](https://github.com/erlingrj/erlingrj.github.io))
++ [Yangkeun Yun's website](https://yangkeunyun.github.io) ([source code](https://github.com/yangkeunyun/yangkeunyun.github.io))
++ [Lucas Warwar's website](https://lucaswarwar.github.io) ([source code](https://github.com/lucaswarwar/lucaswarwar.github.io))
++ [Franz Louis Cesista's website](https://leloykun.github.io) ([source code](https://github.com/leloykun/leloykun.github.io))
++ [Gabe Sekeres's website](https://gabesekeres.com) ([source code](https://github.com/gsekeres/hugo_site))
++ [Kevin Roice's website](https://kevroi.github.io) ([source code](https://github.com/kevroi/kevroi.github.io))
++ [Daniel Barbosa's website](https://dacbarbosa.github.io) ([source code](https://github.com/dacbarbosa/dacbarbosa.github.io))
++ [Wei Zhang's website](https://weizhang-econ.github.io) ([source code](https://github.com/weizhang-econ/weizhang-econ.github.io))
++ [Ben Hermann's website](http://benhermann.eu) ([source code](https://github.com/bhermann/bhermann.github.io))
++ [Franco Corona's website](http://fcorona.me) ([source code](https://github.com/exibios/exibios.github.io))
++ [Tom George's website](https://tomge.org) ([source code](https://github.com/TomGeorge1234/TomGeorge1234.github.io))
++ [Yucheng Zhou's website](https://yuchengzhou.com) ([source code](https://github.com/YuchengZ-Fin/YuchengZ-Fin.github.io))
++ [Rui Sousa's website](https://ruiagmsousa.github.io) ([source code](https://github.com/ruiagmsousa/ruiagmsousa.github.io))
++ [Stefano Sangiovanni's website](https://ste-sangiovanni.github.io) ([source code](https://github.com/ste-sangiovanni/ste-sangiovanni.github.io))
++ [Seth Watts's website](https://www.sethbwatts.com) ([source code](https://github.com/sBwatts/hugo-website))
++ [Louise Demoor's website](https://louisedemoor.github.io/website/) ([source code](https://github.com/louisedemoor/website))
++ [Giwon Bahg's website](https://giwonbahg.github.io) ([source code](https://github.com/giwonbahg/giwonbahg.github.io))
++ [Arthur Douillard's website](https://arthurdouillard.com)
++ [Benjamin Hattemer's website](https://benjaminhattemer.com)
++ [Kostas Bimpikis's website](https://stanford.edu/~kostasb/)
++ [Qiwei He's website](https://www.qiwei-he.com)
++ [Pierre Bardier's website](https://pierrebard.github.io/pierre-bardier/)
++ [Marek Wiewiórka's website](https://marekwiewiorka.org)
++ [Eran Shmuëli's website](https://eranshmueli.com)
++ [Bo Wang's website](https://bowang.finance)
+
+## Related resources
+
++ [latex-cv](https://github.com/pmichaillat/latex-cv) - This LaTeX template produces a minimalist academic CV, which you can post on your website. The CV should be named `cv.pdf` and placed in the `static` folder. It will be accessible from the homepage via a social icon.
++ [latex-paper](https://github.com/pmichaillat/latex-paper) - This LaTeX template produces a minimalist research paper, which you can post on your website. This is the template used to produce the mock papers on the illustrative website: [here](https://pascalmichaillat.org/hugo-website/papers/paper3/paper3.pdf), [here](https://pascalmichaillat.org/hugo-website/papers/paper1/paper1.pdf), and [here](https://pascalmichaillat.org/hugo-website/papers/paper2/paper2.pdf).

archetypes/course.md

@@ -0,0 +1,83 @@
+---
+title: "Course Title (less than 70 characters)" 
+date: 2006-03-15
+url: /course/
+aliases:
+    - /old_url.html
+tags: ["keyword 1","keyword 2","keyword 3","keyword 4","keyword 5","keyword 6","keyword 7","keyword 8"]
+author: ["Course Author 1", "Course Author 2"]
+description: "Course description for search engines (less than 155 characters)" 
+summary: "Course summary for list page (less than 265 characters)
+cover:
+    image: "course_figure.png"
+    alt: "Figure title (preferably 1280x720 pixels)"
+    relative: true
+editPost:
+    URL: "https://youtube.com/course_playlist"
+    Text: "YouTube playlist"
+disableAnchoredHeadings: false
+showToc: true
+
+---
+
+## Introduction
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+---
+
+## Part 1
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. 
+
+##### Lecture videos
+
+1. [Lecture 1](https://youtu.be/lecture_1)
+2. [Lecture 2](https://youtu.be/lecture_2)
+3. [Lecture 3](https://youtu.be/lecture_3)
+
+##### Lecture notes
+
+1. [Lecture 1](lecture_1.pdf)
+2. [Lecture 2](lecture_2.pdf)
+3. [Lecture 3](lecture_3.pdf)
+
+##### Readings
+
+- [Paper 1](https://doi.org/paper_1) – Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
+- [Paper 2](https://doi.org/paper_2) – Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+##### Homework
+
+- [Quiz 1](quiz_1.pdf)
+- [Quiz 2](quiz_2.pdf)
+- [Problem set 1](ps_1.pdf)
+
+---
+
+## Part 2
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. 
+
+##### Lecture videos
+
+1. [Lecture 4](https://youtu.be/lecture_4)
+2. [Lecture 5](https://youtu.be/lecture_5)
+3. [Lecture 6](https://youtu.be/lecture_6)
+
+##### Lecture notes
+
+1. [Lecture 4](lecture_4.pdf)
+2. [Lecture 5](lecture_5.pdf)
+3. [Lecture 6](lecture_6.pdf)
+
+##### Readings
+
+- [Paper 3](https://doi.org/paper_3) – Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
+- [Paper 4](https://doi.org/paper_4) – Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+##### Homework
+
+- [Quiz 3](quiz_3.pdf)
+- [Quiz 4](quiz_4.pdf)
+- [Problem set 2](ps_2.pdf)

archetypes/paper.md

@@ -0,0 +1,63 @@
+---
+title: "Paper Title (less than 70 characters)" 
+date: 2012-06-01
+url: /paper/
+aliases: 
+    - /old_url.html
+tags: ["keyword 1","keyword 2","keyword 3","keyword 4","keyword 5","keyword 6","keyword 7","keyword 8"]
+author: ["Paper Author 1", "Paper Author 2"]
+description: "Paper description for search engines (less than 155 characters)" 
+summary: "Paper summary for list page (less than 265 characters)"
+cover:
+    image: "paper_figure.png"
+    alt: "Figure title (preferably 1280x720 pixels)"
+    relative: true
+editPost:
+    URL: "https://doi.org/paper_doi"
+    Text: "Journal/Repository Name"
+
+---
+
+---
+
+##### Download:
+
+- [Paper](paper.pdf)
+- [Online appendix](appendix.pdf)
+- [Code and data](https://github.com/paper_repo)
+
+---
+
+##### Abstract:
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+---
+
+##### Figure X:  Figure title
+
+![](figurex.png)
+
+---
+
+##### Citation
+
+Author 1, Author 2. Year. "Title." *Journal* Volume (Issue): First page–Last page. https://doi.org/paper_doi.
+
+```BibTeX
+@article{AAYY,
+author = {Author 1 and Author 2},
+doi = {paper_doi},
+journal = {Journal},
+number = {Issue},
+pages = {XXX--YYY},
+title = {Title},
+volume = {Volume},
+year = {Year}}
+```
+
+---
+
+##### Related material
+
++ [Presentation slides](presentation.pdf)

archetypes/search.md

@@ -0,0 +1,5 @@
+---
+title: "Search"
+layout: "search"
+placeholder: "Search website"
+---

assets/css/common/404.css

@@ -0,0 +1,13 @@
+.not-found {
+    position: absolute;
+    top: 0; left: 0; right: 0; bottom: 0;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    font-size: 1.3rem;
+    font-weight: 500;
+    text-align: center;
+    color: var(--secondary);  
+    gap: 2.5rem;
+}