70 lines
3.0 KiB
HTML
70 lines
3.0 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<title>hugo - Caddy Directives</title>
|
|
{{.Include "/includes/docs-head.html"}}
|
|
</head>
|
|
<body>
|
|
<main>
|
|
<h1>hugo <div class="tag addon">Addon</div></h1>
|
|
|
|
<div class="addon-message">
|
|
<div class="heading"><i class="fa fa-plus-circle"></i> Addon</div>
|
|
This directive is a Caddy extension. Questions should be directed to its maintainer. <a href="https://github.com/hacdias/caddy-hugo">github.com/hacdias/caddy-hugo</a>
|
|
</div>
|
|
|
|
<p>
|
|
hugo allows you to deploy and manage a static site with an web-based admin interface where you can edit content, schedule posts, upload files, etc. The admin interface will be available at /admin on your website. It is built to be used with <a href="http://gohugo.io/">Hugo</a> - which is bundled with the plugin so you don't have to install it separately.
|
|
</p>
|
|
|
|
<p>
|
|
<b>Requirements:</b> this add-on does not create a new Hugo site for you; you'll need to run <code>hugo new site</code> if you don't already have a Hugo site.
|
|
</p>
|
|
|
|
<h3>Syntax</h3>
|
|
<code class="block"><span class="hl-directive">root</span> <span class="hl-subdirective">public</span>
|
|
<span class="hl-directive">hugo</span> <span class="hl-subdirective">dir</span> {
|
|
<span class="hl-subdirective">styles</span> <i>file</i>
|
|
<span class="hl-subdirective">args</span> <i>cmd</i>
|
|
}</code>
|
|
|
|
<ul>
|
|
<li><b>public</b> is the folder with the public content.</li>
|
|
<li><b>dir</b> is the folder where the commands are going to be executed. By default, it is the current working directory.</li>
|
|
<li><b>file</b> is the relative path to <code>public</code> folder of the admin UI styles. These styles won't replace the defaults, they will be added.</li>
|
|
<li><b>cmd</b> must be surrounded by double quotes and it corresponds to the Hugo flags you want to use.</li>
|
|
</ul>
|
|
|
|
<p>
|
|
All of the directives above are optional.
|
|
</p>
|
|
|
|
<p>
|
|
To schedule a post, its <code>date</code> field must be in '2006-01-02 15:04:05-07:00' format.
|
|
</p>
|
|
|
|
<p>
|
|
This directive should be used with <a href="/docs/root">root</a>, <a href="/docs/basicauth">basicauth</a> and <a href="/docs/errors">errors</a> middleware to have the best experience. See the examples to know more.
|
|
</p>
|
|
|
|
<h3 id="examples">Examples</h3>
|
|
|
|
<p>
|
|
A simple configuration to use with Hugo static website generator:
|
|
</p>
|
|
|
|
<code class="block"><span class="hl-directive">localhost:8080</span> <span class="hl-comment"># website URL and port</span>
|
|
|
|
<span class="hl-directive">root</span> public <span class="hl-comment"># the folder where Hugo generates the website</span>
|
|
<span class="hl-directive">basicauth</span> /admin user pass <span class="hl-comment"># protect the admin area using HTTP basic auth</span>
|
|
<span class="hl-directive">hugo</span> <span class="hl-comment"># enable the admin panel</span></code>
|
|
|
|
<footer>
|
|
© 2015
|
|
</footer>
|
|
</main>
|
|
|
|
{{.Include "/includes/docs-nav.html"}}
|
|
</body>
|
|
</html>
|