@@ -53,9 +53,20 @@ to review it as soon as we can.
53
53
### Working On The Builder
54
54
55
55
The ` builder ` is the static site generator that turns the markdown files, CSS,
56
- images, and scripts into a website. It lives in the ` builder ` . Most of the time,
57
- you won't need to make changes to the builder and you can follow the
58
- instructions in the _ Contributing Changes_ section above.
56
+ images, and scripts into a website.
57
+
58
+ > [ !NOTE]
59
+ > The package in the builder folder has the ` haskell-org-site ` executable:
60
+ > ```
61
+ > $ cat cabal.project
62
+ > packages: builder
63
+ >
64
+ > $ cat builder/haskell-org.cabal | grep executable
65
+ > executable haskell-org-site
66
+ > ```
67
+
68
+ Most of the time, you won't need to make changes to the builder and you can
69
+ follow the instructions in the _Contributing Changes_ section above.
59
70
60
71
If you want to make a quick change or two, you can continue to use the
61
72
`buildAndWatch` script to rebuild changes, but for more substantial changes this
@@ -66,18 +77,18 @@ builder using either nix or cabal. Directions for both are given below:
66
77
### Manually Building the Site With Cabal
67
78
68
79
If you don't have nix installed, or if you are inside of the project's nix
69
- shell, you will want to use cabal to compile the builder, the only package in
80
+ shell, use cabal to build and execute the builder, the only package in
70
81
the project.
71
82
72
- ``` shell
83
+ ```
73
84
$ cabal build all
85
+ $ cabal exec haskell-org-site build
74
86
```
75
87
76
- Once compiled, execute the builder from the project root directory so that it
77
- can find all of the content.
88
+ With `cabal run` we can do this in one command.
78
89
79
90
```
80
- $ cabal exec haskell-org-site build
91
+ $ cabal run haskell-org-site -- build
81
92
```
82
93
83
94
### Manually Building the Site With Nix
0 commit comments