1
Fork 0

docs: add readme

License: MIT
Signed-off-by: Henrique Dias <hacdias@gmail.com>
This commit is contained in:
Henrique Dias 2020-02-16 19:42:35 +00:00
parent 07d586705e
commit 161f01afc4
1 changed files with 45 additions and 0 deletions

45
README.md Normal file
View File

@ -0,0 +1,45 @@
# Caddy redirects for Hugo
Generate a redirects file compatible with the [`http.redir`](https://caddyserver.com/v1/docs/redir) plugin from Caddy.
## Usage
Add the module import to your Hugo config file:
```yaml
module:
imports:
# other imports
- path: github.com/hacdias/hugo-caddy-redirs
```
Then enable the output file for home:
```yaml
# Optional: disable the generation of HTML aliases.
disableAliases: true
# Mandatory
outputs:
home:
- html # Default
- rss # Default
- redir
```
This will create a `redirects.txt` file on the root of your website. Now you can
add a rule to your Caddy configuration to use this file as the 301 redirects:
```
redir 301 {
import /the/public/path/redirects.txt
}
```
## Thanks
Thanks to @jlelse for the improvement on adding the version with and without the trailing slash.
## License
MIT