|
|
|
# nooo-hbsc
|
|
|
|
|
|
|
|
The new homebrewserver.club website.
|
|
|
|
|
|
|
|
> https://homebrewserver.club/
|
|
|
|
|
|
|
|
## Build the site locally
|
|
|
|
|
|
|
|
### System requirements
|
|
|
|
|
|
|
|
Install the system requirements:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ apt install -y python3 python3-dev python3-venv
|
|
|
|
```
|
|
|
|
|
|
|
|
### Python requirements
|
|
|
|
|
|
|
|
Then create a virtual environment and activate it:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ python3 -m venv .venv
|
|
|
|
$ source .venv/bin/activate
|
|
|
|
```
|
|
|
|
|
|
|
|
Then install the requirements:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ pip install -r requirements.txt
|
|
|
|
```
|
|
|
|
|
|
|
|
### Generating the site
|
|
|
|
|
|
|
|
Generate the content and run the server:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ pelican content
|
|
|
|
$ pelican --listen
|
|
|
|
```
|
|
|
|
|
|
|
|
Then the site is available at the following URL:
|
|
|
|
|
|
|
|
> http://localhost:8000
|
|
|
|
|
|
|
|
## Working with the site
|
|
|
|
|
|
|
|
* Website articles and content is in [content](./content)
|
|
|
|
* The website structure is in [themes/homebrewtheme](./themes/homebrewserver)
|
|
|
|
|
|
|
|
While working on the site, you can run the following:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ invoke livereload
|
|
|
|
```
|
|
|
|
|
|
|
|
And then the Pelican development server will automatically reload
|
|
|
|
when you make changes.
|
|
|
|
|
|
|
|
## Deploying the site
|
|
|
|
|
|
|
|
Just run the usual:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ git push origin master
|
|
|
|
```
|