aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 7451f56a7a70085747300e46dc88764f6df20ed2 (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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
pablotron.org
=============

Overview
--------
[Hugo][] backend for [pablotron.org][].

Content is divided into three [sections][]:

|Section Type|Description|Permalinks|
|------------|-----------|---------|
|`posts`|Blog entries.|`/YYYY/MM/DD/SLUG/`|
|`articles`|Long-form articles.|`/articles/SLUG/`|
|`projects`|Programming projects.|`/SLUG/`|

The 10 most recent `posts` are shown on the home page in reverse
chronological order.  A list of all `posts`, grouped by year, is shown
on the [archive][] page in reverse chronological order.

`articles` are long-form content that doesn't fit nicely as blog posts.

`projects` have a repository link and a brief description.  Eventually I
may add more information (release history, signatures, etc).

Usage
-----
The `bin/new` script allows you (me) to easily create new content:

Add a new post:

    # easy version
    bin/new post some-slug

    # longer version
    hugo new --editor $EDITOR  posts/$(date +%Y-%m-%d)-some-slug.md

Add a new project:

    # easy version
    bin/new project some-slug

    # longer version
    hugo new --editor $EDITOR  projects/some-slug.md

Add a new navbar menu entry:

    # edit navbar menu entries
    vim data/menu.yaml

Theme
-----
The current theme is `hugo-pt2021` and is stored in `themes/hugo-pt2021`
which is included in this repository.

[hugo]: https://gohugo.io/
  "hugo static site generator"
[sections]: https://gohugo.io/content-management/sections/
  "content sections"
[pablotron.org]: https://pablotron.org/
  "the hottest site on the net"
[archive]: https://pablotron.org/archive/
  "post archive"