Welcome to mirror list, hosted at ThFree Co, Russian Federation.

builders.md « extras « content « docs - github.com/gohugoio/hugo.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: 4fdae9418d333a49217cc6f2c3e5432b201924c5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
---
title: "Hugo Builders"
linktitle: "Builders"
date: "2014-05-26"
weight: 12
menu:
  main:
    parent: 'extras'
prev: "/extras/aliases"
next: "/extras/comments"
---

Hugo provides the functionality to quickly get a site, theme or page
started.


## New Site

Want to get a site built quickly?.

    hugo new site /path/to/site

Hugo will create all the needed directories and files to get started
quickly.

Hugo will only touch the files and create the directories (in the right
places), [configuration](/overview/configuration) and content are up to
you... but luckily we have builders for content (see below).

## New Theme

Want to design a new theme?

    hugo new theme `THEME_NAME`

Run from your working directory, this will create a new theme with all
the needed files in your themes directory. Hugo will provide you with a
license and theme.toml file with most of the work done for you.

Follow the [Theme Creation Guide](/themes/creation) once the builder is
done.

## New Content

You will use this builder the most of all. Every time you want to create
a new piece of content, the content builder will get you started right.

Leveraging [content archetypes](/content/archetypes) the content builder
will not only insert the current date and appropriate metadata, but it
will pre-populate values based on the content type.

    hugo new relative/path/to/content

This assumes it is being run from your working directory and the content
path starts from your content directory.

I typically keep two different terminals open, one to run `hugo server
--watch`, and another to use the builders to create new content.