From: Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>
Date: Mon, 24 Sep 2018 09:52:25 +0000 (+0200)
Subject: docs: Document directory based archetypes
X-Git-Tag: v0.49~3
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=369744845046e1aa54205ef4a5dceae0829f8331;p=brevno-suite%2Fhugo

docs: Document directory based archetypes

See #4535
---

diff --git a/docs/content/en/content-management/archetypes.md b/docs/content/en/content-management/archetypes.md
index ff4a2d78..3fc8a9f3 100644
--- a/docs/content/en/content-management/archetypes.md
+++ b/docs/content/en/content-management/archetypes.md
@@ -70,6 +70,28 @@ It will create a new newsletter type of content file based on the archetype temp
 The above _newsletter type archetype_ illustrates the possibilities: The full Hugo `.Site` and all of Hugo&#39;s template funcs can be used in the archetype file.
 
 
+## Directory based archetypes
+
+Since Hugo `0.49` you can use complete directories as archetype templates. Given this archetype directory:
+
+```bash
+archetypes
+├── default.md
+└── post-bundle
+    ├── bio.md
+    ├── images
+    │   └── featured.jpg
+    └── index.md
+```
+
+```bash
+hugo new --kind post-bundle post/my-post
+```
+
+Will create a new folder in `/content/post/my-post` with the same set of files as in the `post-bundle` archetypes folder. All content files (`index.md` etc.) can contain template logic, and will receive the correct `.Site` for the content's language.
+
+
+
 [archetypes directory]: /getting-started/directory-structure/
 [content types]: /content-management/types/
 [front matter]: /content-management/front-matter/