filebrowser/caddy/hugo/README.md

hugo - a caddy plugin

hugo fills the gap between Hugo and the browser. Hugo 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.

Syntax

hugo [directory] [admin] {
    clean_public    [true|false]
    before_publish  command
    after_publish   command
    flag            name  [value]
    # other file manager compatible options
}

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 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, basicauth and 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 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