046da0bcb9 | ||
---|---|---|
.github | ||
assets/public/js | ||
utils | ||
.editorconfig | ||
.jsbeautifyrc | ||
.travis.yml | ||
LICENSE.md | ||
README.md | ||
binary.go | ||
hugo.go | ||
setup.go |
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 an 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 astrue
.
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