From 0e44f75ebd12106e7a2dc602f9d6c650fc356cf2 Mon Sep 17 00:00:00 2001 From: "C. S. Samulski" Date: Fri, 10 Mar 2017 13:56:30 -0500 Subject: [PATCH] docs: Explain themes dir in quickstart guide Themes is currently not included in the description that follows `tree -a` even though it is autogenerated for you by `new site`. --- docs/content/overview/quickstart.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/content/overview/quickstart.md b/docs/content/overview/quickstart.md index 1a2474bdc..a7902cf65 100644 --- a/docs/content/overview/quickstart.md +++ b/docs/content/overview/quickstart.md @@ -78,12 +78,13 @@ $ tree -a |-- content |-- data |-- layouts -`-- static +|-- static +`-- themes -5 directories, 1 file +6 directories, 1 file ``` -As mentioned in the command output, `bookshelf` directory has 5 sub-directories and 1 file. Let's look at each of them one by one. +As mentioned in the command output, `bookshelf` directory has 6 sub-directories and 1 file. Let's look at each of them one by one. * **archetypes**: You can create new content files in Hugo using the `hugo new` command. When you run that command, it adds few configuration properties to the post like date and title. [Archetype]({{< relref "content/archetypes.md" >}}) allows you to define your own configuration properties that will be added to the post front matter whenever `hugo new` command is used. @@ -99,6 +100,8 @@ You can write these files in YAML, JSON, or TOML format. * **static**: This directory is used to store all the static content that your website will need like images, CSS, JavaScript or other static content. +* **themes**: This is where you will create a theme for your site to use. Themes provide the layout and templates that renders content. There's a wide variety of open-source themes available to download and use but you can also create your own if you prefer. + ## Step 3. Add content Let's now add a post to our `bookshelf`. We will use the `hugo new` command to add a post. In January, I read [Good To Great](http://www.amazon.com/Good-Great-Some-Companies-Others/dp/0066620996/) book so we will start with creating a post for it. **Make sure you are inside the `bookshelf` directory.**