2021-11-21 22:47:03 +00:00
|
|
|
# Thurstylark's wiki
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
|
|
|
|
|
- Base
|
|
|
|
|
- hugo
|
2021-11-21 23:29:28 +00:00
|
|
|
- Optional (only required for `tlwiki` management script)
|
2021-11-21 22:47:03 +00:00
|
|
|
- git
|
|
|
|
|
- python3
|
|
|
|
|
- rsync
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Environment Setup
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Using `tlwiki` script
|
|
|
|
|
|
2021-11-21 23:28:29 +00:00
|
|
|
1. Create `tlwiki-conf.yaml` using `tlwiki-conf.yaml.ex` as a template
|
|
|
|
|
2. Run `./tlwiki updeps` to pull in the latest version of all git submodules
|
2021-11-21 22:47:03 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Using individual commands
|
|
|
|
|
|
|
|
|
|
1. Initialize all git submodules
|
|
|
|
|
```
|
|
|
|
|
git submodule update --init --recursive
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Deploy
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Using `tlwiki` script
|
|
|
|
|
|
|
|
|
|
1. Ensure the values for `deployID.user`, `deployID.host`, and `deployID.dir` are correct
|
2021-11-21 23:34:34 +00:00
|
|
|
- For best results, use rsync with a non-interactive authentication method such as ssh key pairs
|
2021-11-21 22:47:03 +00:00
|
|
|
2. Run `./tlwiki deploy`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Using individual commands
|
|
|
|
|
|
|
|
|
|
1. Run `hugo` to build the site
|
|
|
|
|
2. Copy the contents of `public/` to your web server's document root
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Hacking
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Automatically run `./tlwiki deploy` on `git push`
|
|
|
|
|
|
|
|
|
|
Create a symlink named `.git/hooks/pre-push` with `tlwiki` as its target:
|
|
|
|
|
```
|
|
|
|
|
ln -s .git/hooks/pre-push ../../tlwiki
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
`tlwiki` will help manage this symlink in the future (See: [#1](https://git.thurstylark.com/thurstylark/tlwiki/issues/1))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Serve the site locally for testing
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
hugo server
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
More info: https://gohugo.io/commands/hugo_server/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## `tlwiki-config.yaml` Configuration Options
|
|
|
|
|
|
|
|
|
|
| Path | Type | Default | Description |
|
|
|
|
|
|-----------------|--------|---------|----------------------------------------------------------|
|
|
|
|
|
| deployID.user | string | <none> | rsync username (`USER` in `USER@HOST:DIR`) |
|
|
|
|
|
| deployID.host | string | <none> | rsync hostname (`HOST` in `USER@HOST:DIR`) |
|
|
|
|
|
| deployID.dir | string | <none> | rsync target remote directory (`DIR` in `USER@HOST:DIR`) |
|
|
|
|
|
| repo.URL | string | <none> | Unused |
|
|
|
|
|
| repo.branch | string | <none> | Unused |
|
|
|
|
|
| repo.remoteName | string | <none> | Unused |
|
