filebrowser/caddy/hugo
Henrique Dias 5d2e8864e5 A fix for #161
Former-commit-id: 73c31acfa1c812e896c57562338bd1fc27e3a3fb [formerly 15188c05c39a31691a875a57fadc2b397942146c] [formerly 6ad4d891a760572954b88383b41ced35bffc14c2 [formerly 97365f0e16]]
Former-commit-id: cb059d6f523e1f4a158bd504e04ce052ce32ae8b [formerly 945c4570eaa8478e7cea4dea8085a0ad69dfc063]
Former-commit-id: 138a1faefacab94f8ba14e0b72c75dd41fa9b965
2017-07-27 18:05:57 +01:00
..
README.md
hugo.go A fix for #161 2017-07-27 18:05:57 +01:00
hugo.js
rice-box.go
setup.go
utils.go

README.md

hugo - a caddy plugin

community

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. It is an implementation of hacdias/filemanager library.

Requirements: you need to have the hugo executable in your PATH. You can download it from its official page.

Get Started

To start using this plugin you just need to go to the download Caddy page and choose http.hugo in the directives section. For further information on how Caddy works refer to its documentation.

The default credentials are admin for both the user and the password. It is highy recommended to change them after logging in for the first time and to use HTTPS. You can create more users and define their own permissions using the web interface.

Syntax

hugo [directory] [admin] {
    database path
}
  • directory is the path, relative or absolute to the directory of your Hugo files. Defaults to ./.
  • admin is the URL path where you will access the admin interface. Defaults to /admin.
  • path is the database path where the settings will be stored. By default, the settings will be stored on .caddy folder.

Database

By default the database will be stored on .caddy directory, in a sub-directory called hugo. Each file name is an hash of the combination of the host and the base URL.

If you don't set a database path, you will receive a warning like this:

[WARNING] A database is going to be created for your File Manager instace at ~/.caddy/hugo/xxx.db. It is highly recommended that you set the 'database' option to 'xxx.db'

Why? If you don't set a database path and you change the host or the base URL, your settings will be reseted. So it is highly recommended to set this option.

When you set a relative path, such as xxxxxxxxxx.db, it will always be relative to .caddy/hugo directory. Although, you may also use an absolute path if you wish to store the database in other place.

Examples

Manage the current working directory's Hugo website at /admin and display the public folder to the user.

root public
hugo {
  database myinstance.db
}

Manage the Hugo website located at /var/www/mysite at /admin and display the public folder to the user.

root /var/www/mysite/public
hugo /var/www/mysite {
  database myinstance.db
}

Manage the Hugo website located at /var/www/mysite at /private and display the public folder to the user.

root /var/www/mysite/public
hugo /var/www/mysite /private {
  database myinstance.db
}

Known Issues

If you are having troubles handling large files you might need to check out the timeouts plugin, which can be used to change the default HTTP Timeouts.