mirror of
https://github.com/BBaoVanC/bbaovanc.com.git
synced 2025-07-04 02:57:31 -05:00
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
# Contributing to bobatheme
|
|
|
|
## Where to put questions/issues/etc
|
|
|
|
Use the [GitHub Discussions forum][github-discussions-url] for any questions,
|
|
or ideas. Use the "Q&A" section for both questions and issues as well.
|
|
|
|
[github-discussions-url]: https://github.com/BBaoVanC/bbaovanc.com/discussions
|
|
|
|
## Building
|
|
|
|
Just in case you need it.
|
|
|
|
## Automatic deploy previews with GitHub Actions
|
|
|
|
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.
|
|
|
|
## Manual (local) building
|
|
|
|
You can also build the site yourself using Hugo, including a live local preview.
|
|
|
|
1. Make sure you install the latest version of Hugo, or hopefully at least the
|
|
`min_version` listed in
|
|
[theme.toml](https://github.com/BBaoVanC/bobatheme/blob/master/theme.toml#L11).
|
|
Let me know if that minimum version isn't enough and I'll fix it.
|
|
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.
|