2013-07-06 23:36:30 +00:00
|
|
|
---
|
|
|
|
title: "Source Directory Organization"
|
2013-08-17 12:34:25 +00:00
|
|
|
date: "2013-07-01"
|
|
|
|
aliases: ["/doc/source-directory/"]
|
2013-10-25 22:42:46 +00:00
|
|
|
groups: ['gettingStarted']
|
2013-10-26 06:18:14 +00:00
|
|
|
groups_weight: 50
|
2013-07-08 21:57:01 +00:00
|
|
|
---
|
2013-07-04 15:32:55 +00:00
|
|
|
|
|
|
|
Hugo takes a single directory and uses it as the input for creating a complete website.
|
|
|
|
|
|
|
|
Hugo has a very small amount of configuration, while remaining highly customizable.
|
|
|
|
It accomplishes by assuming that you will only provide templates with the intent of
|
|
|
|
using them.
|
|
|
|
|
|
|
|
An example directory may look like:
|
|
|
|
|
|
|
|
.
|
2013-08-03 07:30:34 +00:00
|
|
|
├── config.yaml
|
2013-07-04 15:32:55 +00:00
|
|
|
├── content
|
|
|
|
| ├── post
|
|
|
|
| | ├── firstpost.md
|
|
|
|
| | └── secondpost.md
|
|
|
|
| └── quote
|
|
|
|
| | ├── first.md
|
|
|
|
| | └── second.md
|
|
|
|
├── layouts
|
|
|
|
| ├── chrome
|
|
|
|
| | ├── header.html
|
|
|
|
| | └── footer.html
|
|
|
|
| ├── indexes
|
|
|
|
| | ├── category.html
|
|
|
|
| | ├── post.html
|
|
|
|
| | ├── quote.html
|
|
|
|
| | └── tag.html
|
|
|
|
| ├── post
|
|
|
|
| | ├── li.html
|
|
|
|
| | ├── single.html
|
|
|
|
| | └── summary.html
|
|
|
|
| ├── quote
|
|
|
|
| | ├── li.html
|
|
|
|
| | ├── single.html
|
|
|
|
| | └── summary.html
|
|
|
|
| ├── shortcodes
|
|
|
|
| | ├── img.html
|
|
|
|
| | ├── vimeo.html
|
|
|
|
| | └── youtube.html
|
|
|
|
| ├── index.html
|
|
|
|
| └── rss.xml
|
2013-08-03 07:30:34 +00:00
|
|
|
└── static
|
2013-07-04 15:32:55 +00:00
|
|
|
|
|
|
|
This directory structure tells us a lot about this site:
|
|
|
|
|
|
|
|
1. the website intends to have two different types of content, posts and quotes.
|
|
|
|
2. It will also apply two different indexes to that content, categories and tags.
|
|
|
|
3. It will be displaying content in 3 different views, a list, a summary and a full page view.
|
|
|
|
|
2013-07-04 17:03:16 +00:00
|
|
|
Included with the repository is this example site ready to be rendered.
|