mirror of
https://github.com/filebrowser/filebrowser.git
synced 2024-06-07 23:00:43 +00:00
2d0c90657c
Former-commit-id: 987a3c3c697fb3d529634c1a8f66dde0f450f5a1 [formerly ee09941b44acdf0700d756d72e225a161471dcd2] [formerly e0243da57fccd6a4765a2c16e4ee45356d76062f [formerly f2b880dccf]]
Former-commit-id: 4a1e27fbe8a524a0eb90f7ae157253ba2d6d29a4 [formerly 66a205c72125cf1666468a21097926196214bb0b]
Former-commit-id: 3b974ca50af3176bcc6497bbda18deef5347cbe5
49 lines
2.9 KiB
Markdown
49 lines
2.9 KiB
Markdown
# hugo - a caddy plugin
|
|
|
|
[](https://caddy.community)
|
|
|
|
hugo fills the gap between Hugo and the browser. [Hugo](http://gohugo.io/) is an easy and fast static website generator. This plugin fills the gap between Hugo and the end-user, providing you a web interface to manage the whole website.
|
|
|
|
Using this plugin, you won't need to have your own computer to edit posts, neither regenerate your static website, because you can do all of that just through your browser.
|
|
|
|
**Requirements:** you need to have the hugo executable in your PATH. You can download it from its [official page](http://gohugo.io).
|
|
|
|
### Syntax
|
|
|
|
```
|
|
hugo [directory] [admin] {
|
|
database path
|
|
}
|
|
```
|
|
|
|
All of the options above are optional.
|
|
|
|
* **directory** is the folder where the commands are going to be executed. By default, it is the current working directory. Default: `./`.
|
|
* **admin** is the path where you will find your administration interface. Default: `/admin`.
|
|
* **clean_public** sets if the `public` folder should be removed before generating the website again. Default: `true`.
|
|
* **before_publish** and **after_publish** allow you to set a custom command to be executed before publishing and after publishing a post/page. The placeholder `{path}` can be used and it will be replaced by the file path.
|
|
* **name** refers to the Hugo available flags. Please use their long form without `--` in the beginning. If no **value** is set, it will be evaluated as `true`.
|
|
|
|
In spite of these options, you can also use the [filemanager](https://caddyserver.com/docs/http.filemanager) so you can have more control about what can be acceded, the permissions of each user, and so on.
|
|
|
|
This directive should be used with [root](https://caddyserver.com/docs/root), [basicauth](https://caddyserver.com/docs/basicauth) and [errors](https://caddyserver.com/docs/errors) middleware to have the best experience. See the examples to know more.
|
|
|
|
### Examples
|
|
|
|
If you don't already have an Hugo website, don't worry. This plugin will auto-generate it for you. But that's not everything. It is recommended that you take a look at Hugo [documentation](http://gohugo.io/themes/overview/) to learn more about themes, content types, and so on.
|
|
|
|
A simple Caddyfile to use with Hugo static website generator:
|
|
|
|
```
|
|
root public # the folder where Hugo generates the website
|
|
basicauth /admin user pass # protect the admin area using HTTP basic auth
|
|
hugo # enable the admin panel
|
|
```
|
|
|
|
### Screenshots
|
|
|
|
|
|
|
|
|
|
|