aboutsummaryrefslogtreecommitdiffgithub
path: root/README.md
blob: ec679b92b68241802cda26b18d1fc5543d712ff9 (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
35
36
37
38
39
40
41
42
My Hugo Website
===============

This is the statically-generated portion of my website, written using
[Hugo][1].

Getting Started
---------------

After cloning the repository and [installing hugo][2], run `hugo` to generate
the site, and `hugo serve` to run a temporary HTTP server at
<http://localhost:1313/>. (Pages served by the latter auto-refresh while you're
working; it's super convenient)

Tricks
------

### Atomically re-generating the site when pushing to the repo

When I push to a repository on the server hosting my site, it re-generates
automatically! I wrote [a blog post][3] with more details.

### Including recent git commits

The homepage includes recent commits I've made using content generated by a
quick C program I wrote named gustave ([github][4], [cgit][5]). Using a similar
strategy as above, whenever I push to any of my repositories, a git
post-receive hook runs, running gustave and then hugo to re-generate the site.

See [my blog post][6] for more information.

*Note: as of October 2022, I removed recent commits from the front page of my
website for career-change reasons, but if you want to see what the recent
commits listing used to look like, [you can try the Internet Archive][7].*

[1]: https://gohugo.io/
[2]: https://github.com/spf13/hugo/releases
[3]: https://austinjadams.com/blog/using-git-to-deploy-a-hugo-blog-atomically/
[4]: https://github.com/ausbin/gustave/
[5]: https://code.austinjadams.com/gustave/
[6]: https://austinjadams.com/blog/including-recent-commits-hugo/
[7]: http://web.archive.org/web/20190124070113/https://austinjadams.com/