From 0f8f51414d9e600129353781c41aded7c83a3947 Mon Sep 17 00:00:00 2001 From: David Turnbull Date: Mon, 12 Jun 2017 16:03:08 +1000 Subject: [PATCH] =?UTF-8?q?docs:=20Rewrite=20=E2=80=9CArchetypes=E2=80=9D?= =?UTF-8?q?=20article?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/content/content/archetypes.md | 362 +++++++++++++----- .../archetypes/archetype-hierarchy.png | Bin 0 -> 38799 bytes 2 files changed, 271 insertions(+), 91 deletions(-) create mode 100644 docs/static/img/content/archetypes/archetype-hierarchy.png diff --git a/docs/content/content/archetypes.md b/docs/content/content/archetypes.md index d510456a9..580783dec 100644 --- a/docs/content/content/archetypes.md +++ b/docs/content/content/archetypes.md @@ -11,140 +11,320 @@ weight: 50 toc: true --- -In Hugo v0.11, we introduced the concept of a content builder. Using the CLI -command hugo new [path/to/my/content], an author could -create an empty content file, with the date and title automatically defined in -the front matter of the post. While this was a welcome feature, active writers -need more flexibility. - -When defining a custom content type, you can use an **archetype** as a way to -define the default metadata for a new post of that type. - -**Archetypes** are quite literally archetypal content files with pre-configured -[front matter](/content/front-matter). An archetype will populate each new -content file of a given type with any default metadata you've defined whenever -you run the `hugo new` command. - -## Example - -### Step 1. Creating an archetype - -In the following example scenario, suppose we have a blog with a single content -type (blog post). Our imaginary blog will use ‘tags’ and ‘categories’ for its -taxonomies, so let's create an archetype file with ‘tags’ and ‘categories’ -pre-defined: - -#### archetypes/default.md +Typically, each piece of content you create within a Hugo project will have [front matter](/content/front-matter/) that follows a consistent structure. If you write blog posts, for instance, you might use the following front matter for the vast majority of those posts: ```toml +++ -tags = ["x", "y"] -categories = ["x", "y"] +title = "" +date = "" +slug = "" +tags = [ + "" +] +categories = [ + "" +] +draft = true +++ ``` -> __CAVEAT:__ Some editors (e.g. Sublime, Emacs) do not insert an EOL (end-of-line) character at the end of the file (i.e. EOF). If you get a [strange EOF error](/troubleshooting/strange-eof-error/) when using `hugo new`, please open each archetype file (i.e. `archetypes/*.md`) and press Enter to type a carriage return after the closing `+++` or `---` as necessary. +You can always add non-typical front matter to any piece of content, but since it takes extra work to develop a theme that handles unique metadata, consistency is simpler. +With this in mind, Hugo has a convenient feature known as *archetypes* that allows users to define default front matter for new pieces of content. -### Step 2. Using the archetype +By using archetypes, we can: -Now, with `archetypes/default.md` in place, let's create a new post in the `post` -section with the `hugo new` command: +1. **Save time**. Stop writing the same front matter over and over again. +2. **Avoid errors**. Reduce the odds of typos, improperly formatted syntax, and other simple mistakes. +3. **Focus on more important things**. Avoid having to remember all of the fields that need to be associated with each piece of content. (This is particularly important for larger projects with complex front matter and a variety of content types.) - $ hugo new post/my-new-post.md +Let's explore how they work. -Hugo will now create the file with the following contents: +## Built-in Archetypes -#### content/post/my-new-post.md +If you've been using Hugo for a while, there's a decent chance you've come across archetypes without even realizing it. This is because Hugo includes a basic, built-in archetype that is used by default whenever it generates a content file. + +To see this in action, open the command line, navigate into your project's directory, and run the following command: + +```bash +hugo new hello-world.md +``` + +This `hugo new` command creates a new content file inside the project's `content` directory — in this case, a file named `hello-world.md` — and if you open this file, you'll notice it contains the following front matter: ```toml +++ -title = "my new post" -date = "2015-01-12T19:20:04-07:00" -tags = ["x", "y"] -categories = ["x", "y"] +date = "2017-05-31T15:18:11+10:00" +draft = true +title = "hello world" +++ ``` -We see that the `title` and `date` variables have been added, in addition to the -`tags` and `categories` variables which were carried over from `archetype/default.md`. +Here, we can see that three fields have been added to the document: a `title` field that is based on the file name we defined, a `draft` field that ensures this content won't be published by default, and a `date` field that is auto-populated with the current date and time in the [RFC 3339](https://stackoverflow.com/questions/522251/whats-the-difference-between-iso-8601-and-rfc-3339-date-formats) format. -Congratulations! We have successfully created an archetype and used it to -quickly scaffold out a new post. But wait, what if we want to create some content -that isn't exactly a blog post, like a profile for a musician? Let's see how -using **archetypes** can help us out. +This, in its most basic form, is an example of an archetype. To understand how useful they can be though, it's best if we create our own. -### Creating custom archetypes +## Creating Archetypes -Previously, we had created a new content type by adding a new subfolder to the -content directory. In this case, its name would be `content/musician`. To begin -using a `musician` archetype for each new `musician` post, we simply need to -create a file named after the content type called `musician.md`, and put it in -the `archetypes` directory, similar to the one below. +In this section, we're going to create an archetype that will override the built-in archetype, allowing us to define custom front matter that will be included in any content files that we generate with the `hugo new` command. -#### archetypes/musician.md +To achieve this, create a file named `default.md` inside the `archetypes` folder of a Hugo project. (If the folder doesn't exist, create it.) + +Then, inside this file, define the following front matter: ```toml +++ -name = "" -bio = "" -genre = "" +slug = "" +tags = [] +categories = [] +draft = true +++ ``` -Now, let's create a new musician. +You'll notice that we haven't defined a `title` or `date` field. This is because Hugo will automatically add these fields to the beginning of the front matter. We do, however, need to define the `draft` field if we want it to exist in our front matter. - $ hugo new musician/mozart.md +You'll also notice that we're writing the front matter in the TOML format. It's possible to define archetype front matter in other formats, but a setting needs to be changed in the configuration file for this to be possible. See the "[Archetype Formats](#archetype-formats)" section of this article for more details. -This time, Hugo recognizes our custom `musician` archetype and uses it instead of -the default one. Take a look at the new `musician/mozart.md` post. You should see -that the generated file's front matter now includes the variables `name`, `bio`, -and `genre`. +Next, run the following command: -#### content/musician/mozart.md +```bash +hugo new my-archetype-example.md +``` + +This command will generate a file named `my-archetype-example.md` inside the `content` directory, and this file will contain the following output: ```toml +++ -title = "mozart" -date = "2015-08-24T13:04:37+02:00" -name = "" -bio = "" -genre = "" +categories = [] +date = "2017-05-31T15:21:13+10:00" +draft = true +slug = "" +tags = [] +title = "my archetype example" +++ ``` -## Using a different front matter format +As we can see, the file contains the `title` and `date` property that Hugo created for us, along with the front matter that we defined in the `archetypes/default.md` file. -By default, the front matter will be created in the TOML format -regardless of what format the archetype is using. +You'll also notice that the fields have been sorted into alphabetical order. This is an unintentional side-effect that stems from the underlying code libraries that Hugo relies upon. It is, however, [a known issue that is actively being discussed](https://github.com/spf13/hugo/issues/452). -You can specify a different default format in your site-wide config file -(e.g. `config.toml`) using the `MetaDataFormat` directive. -Possible values are `"toml"`, `"yaml"` and `"json"`. +## Section Archetypes -## Which archetype is being used +By creating the `archetypes/default.md` file, we've created a default archetype that is more useful than the built-in archetype, but since Hugo encourages us to [organize our content into sections](/content/sections/), each of which will likely have different front matter requirements, a "one-size-fits-all" archetype isn't necessarily the best approach. -The following rules apply when creating new content: +To accommodate for this, Hugo allows us to create archetypes for each section of our project. This means, whenever we generate content for a certain section, the appropriate front matter for that section will be automatically included in the generated file. -* If an archetype with a filename matching the new post's [content type](/content/types) exists, it will be used. -* If no match is found, `archetypes/default.md` will be used. -* If neither is present and a theme is in use, then within the theme: - * If an archetype with a filename that matches the content type being created, it will be used. - * If no match is found, `archetypes/default.md` will be used. -* If no archetype files are present, then the one that ships with Hugo will be used. +To see this in action, create a "photo" section by creating a directory named "photo" inside the `content` directory. -Hugo provides a simple archetype which sets the `title` (based on the -file name) and the `date` in RFC 3339 format based on -[`now()`](http://golang.org/pkg/time/#Now), which returns the current time. +Then create a file named `photo.md` inside the `archetypes` directory and include the following front matter inside this file: -> *Note: `hugo new` does not automatically add `draft = true` when the user -> provides an archetype. This is by design, rationale being that -> the archetype should set its own value for all fields. -> `title` and `date`, which are dynamic and unique for each piece of content, -> are the sole exceptions.* +```toml ++++ +image_url = "" +camera = "" +lens = "" +aperture = "" +iso = "" +draft = true ++++ +``` -The content type is automatically detected based on the file path passed to the -Hugo CLI command hugo new [my-content-type/post-name]. To -override the content type for a new post, include the `--kind` flag during creation. +Here, the critical detail is that the `photo.md` file in the `archetypes` directory is named after the `photo` section that we just created. By sharing a name, Hugo can understand that there's a relationship between them. -> *Note: if you wish to use archetypes that ship with a theme, the theme MUST be specified in your `config.toml`.* +Next, run the following command: + +```bash +hugo new photo/my-pretty-cat.md +``` + +This command will generate a file named `my-pretty-cat.md` inside the `content/photo` directory, and this file will contain the following output: + +```toml ++++ +aperture = "" +camera = "" +date = "2017-05-31T15:25:18+10:00" +draft = true +image_url = "" +iso = "" +lens = "" +title = "my pretty cat" ++++ +``` + +As we can see, the `title` and `date` fields are still included by Hugo, but the rest of the front matter is being generated from the `photo.md` archetype instead of the `default.md` archetype. + +### Tip: Default Values + +To make archetypes more useful, define default values for any fields that will always be set to a range of limited options. In the case of the `photo.md` archetype, for instance, you could include lists of the various cameras and lenses that you own: + +```toml ++++ +image_url = "" +camera = [ + "Sony RX100 Mark IV", + "Canon 5D Mark III", + "iPhone 6S" +] +lens = [ + "Canon EF 50mm f/1.8", + "Rokinon 14mm f/2.8" +] +aperture = "" +iso = "" +draft = true ++++ +``` + +Then, after generating a content file, simply remove the values that aren't relevant. This saves you from typing out the same options over and over again while ensuring consistency in how they're written. + +## Scaffolding Content + +Archetypes aren't limited to defining default front matter. They can also be used to define a default structure for the body of Markdown documents. + +For example, imagine creating a `review.md` archetype for the purpose of writing camera reviews. This is what the front matter for such an archetype might look like: + +```toml ++++ +manufacturer = "" +model = "" +price = "" +releaseDate = "" +rating = "" ++++ +``` + +But reviews tend to follow strict formats and need to answer specific questions, and it's with these expectations of precise structure that archetypes can prove to be even more useful. + +For the sake of writing reviews, for instance, we could define the structure of a review beneath the front matter of the `review.md` file: + +```markdown ++++ +manufacturer = "" +model = "" +price = "" +releaseDate = "" +rating = "" ++++ + +## Introduction + +## Sample Photos + +## Conclusion +``` + +Then, whenever we use the `hugo new` command to create a new review, not only will the default front matter be copied into the newly created Markdown document, but the body of the `review.md` archetype will also be copied. + +To take this further though — and to ensure authors on multi-author websites are on the same page about how content should be written — we could include notes and reminders within the archetype: + +```markdown ++++ +manufacturer = "" +model = "" +price = "" +releaseDate = "" +rating = "" ++++ + +## Introduction + + + +## Sample Photos + + + +## Conclusion + + + +``` + +That way, each time we generate a new content file, we have a series of handy notes to push us closer to a piece of writing that's suitable for publishing. + +(If you're wondering why the notes are wrapped in the HTML comment syntax, it's to ensure they won't appear inside the preview window of whatever Markdown editor the author happens to be using. They're not strictly necessary though.) + +This is still a fairly simple example, but if your content usually contains a variety of components — headings, bullet-points, images, [short-codes](/extras/shortcodes/), etc — it's not hard to see the time-saving benefits of placing these components in the body of an archetype file. + +## Theme Archetypes + +Whenever you generate a content file with the `hugo new` command, Hugo will start by searching for archetypes in the `archetypes` directory, initially looking for an archetype that matches the content's section and falling-back on the `default.md` archetype (if one is present). If no archetypes are found in this directory, Hugo will continue its search in the `archetypes` directory of the currently active theme. In other words, it's possible for themes to come packaged with their own archetypes, ensuring that users of that theme format their content files with correctly structured front matter. + +To allow Hugo to use archetypes from a theme, [that theme must be activated via the project's configuration file](/themes/usage/): + +```toml +theme = "ThemeNameGoesHere" +``` + +If an archetype doesn't exist in the `archetypes` directory at the top-level of a project or inside the `archetypes` directory of an active theme, the built-in archetype will be used. + +{{< figure src="/img/content/archetypes/archetype-hierarchy.png" alt="How Hugo Decides Which Archetype To Use" >}} + +## Archetype Formats + +By default, the `hugo new` command will generate front matter in the TOML format. This means, even if we define the front matter in our archetype files as YAML or JSON, it will be converted to the TOML format before it ends up in our content files. + +Fortunately, this functionality can be overwritten. + +Inside the project's configuration file, simply define a `metaDataFormat` property: + +```toml +metaDataFormat = "" +``` + +Then set this property to any of the following values: + +* toml +* yaml +* json + +By defining this option, any front matter will be generated in your preferred format. + +It's worth noting, however, that when generating front matter in the TOML format, you might encounter the following error: + +```bash +Error: cannot convert type to TomlTree +``` + +This is because, to generate TOML, all of the fields in the front matter need to have a default value, even if that default value is just an empty string. + +For example, this YAML would *not* successfully compile into the TOML format: + +```yaml +--- +slug: +tags: +categories: +draft: +--- +``` + +But this YAML *would* successfully compile: + +```yaml +--- +slug: "" +tags: + - +categories: + - +draft: true +--- +``` + +It's a subtle yet important detail to remember. + +## Notes + +* Prior to Hugo v0.13, some users received [an "EOF" error when using archetypes](https://github.com/spf13/hugo/issues/776), related to what text editor they used to create the archetype. As of Hugo v0.13, this error has been [resolved](https://github.com/spf13/hugo/pull/785). diff --git a/docs/static/img/content/archetypes/archetype-hierarchy.png b/docs/static/img/content/archetypes/archetype-hierarchy.png new file mode 100644 index 0000000000000000000000000000000000000000..cb0d0bcf4e6ed115bcce92a4c137cb807cc495f5 GIT binary patch literal 38799 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 kVq`cmst3?EVE5m{9#s#*j0bWgLV