Workshop Guide
Welcome to the tutorial! By the end of this tutorial, this webpage will be yours! Yay!
Before the Workshop⌗
Make sure you have done the following before you arrive. If something doesn’t work, come early and we’ll sort it out.
Planning what you want your page to look like⌗
- Find 1-2 webpages of scholars that you like. Consider: What info do they give about themselves? How do they list their publications, interests, etc?
Accounts to create⌗
- GitHub — where your website’s code lives
- Netlify — where your website gets published
- KiloCode - gives you access to agentic AI coding (for free)
Software to install⌗
Attention: if you’re on a MacBook, I suggest first installing Homebrew and then using it to install these things.
- VSCodium — your code editor (free, open-source version of VS Code)
- Hugo — the tool that will “build” your site. Follow the instructions for your operating system on that page. (Once again, if Mac use the homebrew instructions!)
- Git — version control. Follow the instructions for your operating system.
- GitHub Desktop — a visual interface for Git. After installing, sign in with your GitHub account.
- KiloCode — First, open VSCodium: open VSCodium. Then click the Extensions icon (left sidebar, looks like four squares forming a bigger square) → search “Kilo Code” → Install
Readiness check — do this before the workshop⌗
Go through each item below. If any of them fail, try to solve it a bit before coming to our meetup (e.g. use a search engine or ask UvA AI Chat).
| Check | How to test |
|---|---|
| VSCodium opens | Launch it — you should see the editor |
| GitHub Desktop opens | Launch it — you should be logged in to your GitHub account |
| KiloCode is ready | Open VSCodium → click the robot icon → you should see a chat box and your model selected |
Then, using the terminal:
- Mac: press
Cmd + Space, type “Terminal”, press Enter - Windows: press the Windows key, type “PowerShell”, press Enter
| Check | How to test |
|---|---|
| Hugo is installed | Open a terminal and type hugo version — you should see a version number |
| Git is installed | Open a terminal and type git --version — you should see a version number |
If all is good, you’re ready for the workshop! Yay!