2021-10-16 00:22:28 -05:00
|
|
|
# Contributing to bobatheme
|
|
|
|
|
|
|
|
## Building
|
|
|
|
|
2022-04-18 03:04:52 -05:00
|
|
|
Just in case you need it.
|
|
|
|
|
2023-11-15 11:39:17 -06:00
|
|
|
### Automatic deploy previews with GitHub Actions
|
2021-10-16 00:22:28 -05:00
|
|
|
|
2022-04-06 09:47:08 -05:00
|
|
|
My GitHub Actions workflows will automatically build each pull request into a
|
|
|
|
public deploy preview on demo.bbaovanc.com, and will link it in a comment.
|
2021-10-16 00:22:28 -05:00
|
|
|
|
2023-11-15 11:39:17 -06:00
|
|
|
### Manual (local) building
|
2021-10-16 00:22:28 -05:00
|
|
|
|
|
|
|
You can also build the site yourself using Hugo, including a live local preview.
|
|
|
|
|
2022-04-18 03:04:52 -05:00
|
|
|
1. Make sure you install the latest version of Hugo, or hopefully at least the
|
2021-10-16 00:22:28 -05:00
|
|
|
`min_version` listed in
|
|
|
|
[theme.toml](https://github.com/BBaoVanC/bobatheme/blob/master/theme.toml#L11).
|
2022-04-18 03:04:52 -05:00
|
|
|
Let me know if that minimum version isn't enough and I'll fix it.
|
2021-10-16 00:22:28 -05:00
|
|
|
2. Clone the repo
|
|
|
|
3. Make sure to download and checkout the submodules (use `git submodule update
|
|
|
|
--init --recursive`). The `--recursive` flag is especially important because
|
|
|
|
bobatheme has a submodule in itself for icons.
|
|
|
|
4. Run `hugo serve -D` to run a local webserver. Hugo will show the URL you can
|
|
|
|
access the preview at. It will automatically rebuild and reload pages when
|
|
|
|
you save them.
|