aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 9d16175e14906ca8d58d535c0413b22adc8b3cbc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# rgdd.se
This website is built using [Hugo](https://gohugo.io/) and the
[researcher](https://github.com/ojroques/hugo-researcher) theme.

## Quick start after cloning

1. Run `git submodule update --init --recursive`, then apply themes patch.
2. Follow the instruction [here](https://gohugo.io/getting-started/installing/#fetch-from-github)
to install extended Hugo.
3. Try serving the website locally
	1. Run `hugo serve`
	2. Browse http://localhost:1313

## Updating the theme

If the local submodule is behind, run:

    git submodule update

## Upgrading the hugo-theme submodule

If the remote submodule contains updates, run:

    (cd themes/www-theme && git checkout main && git pull origin main)
    git add themes/www-theme

## Create a new post
Blog posts live in the `content/post` directory.  You can use Hugo to generate
a basic template (`hugo new post/mypost.md`), or peak at a previous post.

## Generate a new website that can be published
1. Check that it runs as expected locally (see quick start, step 3).
2. Run `hugo`.  This will update the `public` repository that is deployed somewhere.
3. `rsync -r public/* nemo:/var/www/rgdd.se/`