Creating and Hosting an Academic Personal
Website Using Hugo and GitHub
Connected_Politics Lab Workshop Series
Natalia Umansky and Stefan Müller
13 Novemb er 2020
https://nataliaumansky.github.io | https://muellerstefan.net
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
1
1. Why is it important to have a personal academic website?
2. What should be included on the website?
3. Creating the website
4. Deploying the website
5. Questions
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
2
About Me: Natalia
Education
2018–To date: PhD In Politics and International Relations (University
College D ublin)
Research Interests
International Relations
Critical Security Studies
Computational Social Science
Social Media Communication
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
3
About Me: Stefan
Education and Positions
2015–2018: PhD in Political Science (Trinity College Dublin)
2019: Postdoctoral Researcher (University of Zurich)
since 2020: Assistant Professor (University College Dublin)
Research Interests
Party Competition
Political Communication
Public Opinion and Voting Behaviour
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
4
Content
We will cover:
Advantages of having a personal academic website
Structure of the website:
What information should be included
Advantages and disadvantages of dierent themes
How to create the website:
Creating a new project
Basic Markdown commands
Basic HTML commands
Working with the cong.toml file
Adding content
Personalizing the website
How to deploy the website using GitHub
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
5
Content
We will not cover:
CSS files to override theme attributes
Other Hugo themes
Linking website to custom domain
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
6
Why is it important to have a
personal academic website?
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
7
Advantages of a Website
Visibility
Present your (published and) ongoing research
Contact details
Durability (researcher profiles on university websites change or you
change the institution)
It’s free or very cheap (if you add your custom domain)
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
8
What should be included on the
website?
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
9
Introduction:
Your full name
Picture (a picture you would show to your future employer)
Your position
Aliation
Outlining your work in 1-2 sentences
Research interests
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
10
Your research:
A PDF version of your CV
List of your research projects
Produce separate lists for publications, papers under review, working
pap ers, work in progress, etc.
Attach PDF drafts of your working papers (if they have the required
standard)
Provide links to published work
Add abstracts
Your teaching experience:
List of modules/courses/workshops you teach or taught in the past
Where p ossible, add link to teaching materials
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
11
Personal taste/advice: Keep it simple and professional:
No nee d for very overly long bios
No nee d for (background) photos, fancy colors or spectacular fonts
No nee d for description of hobbies or free-time activities
Make sure all central information can be found in less than 20
seconds (research, contact details, CV)
Check that the website is displayed well on mobile devices
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
12
Contact information:
Email address
Social me dia accounts (if you are an active user)
GitHub account
Location
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
13
Example
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
14
Creating the website
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
15
Hugo themes
Complete list: https://themes.gohugo.io
Today we will be working with the Researcher theme:
https://themes.gohugo.io/hugo-researcher/
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
16
Code
install.packages(blogdown)
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
17
Create a new R project
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
18
Create a new directory
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
19
Choose project type
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
20
Select the theme
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
21
Exercise #1: Create a new project
Breakout rooms:
Introduce yourself (where are you based; what are you
studying/working on)
Repeat the steps to create a new R project for your website using the
‘Researcher’ theme
Questions?:Usementi.com (code: 88 29 53 7)
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
22
Code
library(blogdown)
options(blogdown.publishDir = path/to/folder)
build_site()
serve_site()
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
23
config.toml
This file will ope n automatically when we create the project
From here we can manage:
Website title
Author
Description
Main menu
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
24
_index.md
We can nd this le under in the content folder
From this file, we will add most of the content of our website (at
least in this template)
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
25
R Markdown commands:
We will use:
Images
Links
Tables
Check the R Markdown cheat sheet: https:
//rstudio.com/wp-content/uploads/2015/02/rmarkdown-cheatsheet.pdf
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
26
HTML commands
We will use:
Breaks
Paragraphs
Details + summary
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
27
Adding pictures and attachments to your website
Avatar picture and CV:
To change the picture and the CV attached to the example website,
we must first add our own in the directory.
Pictures and PDF files must be saved in the static folder.
We can then change the file name in the file path.
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
28
Contact information
We can manage the c ontact information from the
contact.md
file, which
is in the conte nt folder
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
29
Exercise #2: Adding content
Breakout rooms:
Introduce yourself (where are you based; what are you
studying/working on).
Make changes to the config.toml file to add your name,
description, and manage the main menu.
Add your bio by making some changes to the _index.md file.
Bonus: Create three sections: Research, Teaching, and CV (where you’ll
add content) and change the avatar picture to show your own.
Questions?:Usementi.com (code: 88 29 53 7)
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
30
Deploying the website
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
31
Building the website
Store your scripts for the website in one folder
Create a separate folder and GitHub repository and name it like your
preferred GitHub domain (e.g. nataliaumansky.github.io)
Run the following code after opening the website folder in your
RProject
library(blogdown)
# set directory where the built website is stored
options(blogdown.publishDir = ../nataliaumansky.github.io)
build_site()
serve_site()
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
32
Pushing the website to GitHub
Use GitHub Desktop (or RStudio) to push the repository
(nataliaumansky.github.io)toGitHub
Go to github.com, selec t this repository, go to Settings and activate
GitHub pages
Source: Branch: master; ‘/root“
[Add custom domain (needs to be set up with the provider of the
domain)]
Activate Enforce HTTPS
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
33
Feedback
Please fill in the following feedback form: tinyurl.com/websiteconnectedpol
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
35
Questions
Connected_Politics Lab Workshop Series (Natalia Umansky Stefan Müller)
36