diff --git a/config.toml b/config.toml index 257c70e27..891fba629 100644 --- a/config.toml +++ b/config.toml @@ -78,7 +78,8 @@ watch = true ## Gh repo for site footer ghrepo = "https://github.com/spf13/hugo/" ## GitHub Docs Repository Base URL (include trailing slash) - ghdocsrepo = "https://github.com/rdwatters/hugo-docs-concept/" + # ghdocsrepo = "https://github.com/rdwatters/hugo-docs-concept/" + ghdocsrepo = "" ## Github Wiki for Documentation ghdocswiki = "" ## Github Wiki for Development diff --git a/content/about-hugo/_index.md b/content/about-hugo/_index.md index 51c884407..b35a5319b 100644 --- a/content/about-hugo/_index.md +++ b/content/about-hugo/_index.md @@ -15,22 +15,11 @@ notes: ## What is Hugo? -Hugo is a general-purpose website framework. Technically speaking, Hugo is -a [static site generator][]. Unlike systems that dynamically build a page -with each visitor request, Hugo builds pages when you create -your content. Since websites are viewed far more often than they are -edited, Hugo is optimized for website viewing for the end users of your site and an ideal writing experience for authors. +Hugo is a general-purpose website framework. Technically speaking, Hugo is a [static site generator][]. Unlike systems that dynamically build a page with each visitor request, Hugo builds pages when you create your content. Since websites are viewed far more often than they are edited, Hugo is designed to provide an optimal viewing experience for your website's end users and an ideal writing experience for authors. -Sites built with Hugo are extremely fast and secure. Hugo sites can -be hosted anywhere, including [Heroku][], [GoDaddy][], [DreamHost][], -[GitHub Pages][], [Surge][], [Aerobatic][], [Firebase Hosting][], -[Google Cloud Storage][], [Amazon S3][], and [CloudFront][] and work well -with CDNs. Hugo sites run without the need for a database or dependencies on expensive runtimes like Ruby, Python, or PHP. +Websites built with Hugo are extremely fast and secure. Hugo sites can be hosted anywhere, including [Heroku][], [GoDaddy][], [DreamHost][], [GitHub Pages][], [Surge][], [Aerobatic][], [Firebase][], [Google Cloud Storage][], [Amazon S3][], and [CloudFront][] and work well with CDNs. Hugo sites run without the need for a database or dependencies on expensive runtimes like Ruby, Python, or PHP. -We think of Hugo as the ideal website creation tool. With nearly instant -build times and the ability to rebuild whenever a change is made, Hugo -provides a very fast feedback loop. This is essential when you are -designing websites, but also very useful when creating content. +We think of Hugo as the ideal website creation tool. With nearly instant build times and the ability to rebuild whenever a change is made, Hugo provides a very fast feedback, which is essential when you are designing websites and creating content. ## How Fast is Hugo? @@ -39,38 +28,26 @@ designing websites, but also very useful when creating content. ## What Does Hugo Do? -In technical terms, Hugo takes a source directory of files and -templates and uses these as input to create a complete website. +In technical terms, Hugo takes a source directory of files and templates and uses these as input to create a complete website. ## Who Should Use Hugo? -Hugo is for people that prefer writing in a text editor over -a browser. +Hugo is for people that prefer writing in a text editor over a browser. -Hugo is for people who want to hand code their own website without -worrying about setting up complicated runtimes, dependencies and -databases. +Hugo is for people who want to hand code their own website without worrying about setting up complicated runtimes, dependencies and databases. -Hugo is for people building a blog, company site, portfolio, tumblog, -documentation, single-page website, or a website with thousands of -pages. - -## See Also - -* [Hugo Performance Benchmark(@bep)] +Hugo is for people building a blog, a company site, a portfolio site, documentation, a single landing page, or a website with thousands of pages. [Aerobatic]: https://www.aerobatic.com/ [Amazon S3]: http://aws.amazon.com/s3/ [CloudFront]: http://aws.amazon.com/cloudfront/ "Amazon CloudFront" [DreamHost]: http://www.dreamhost.com/ -[Firebase Hosting]: https://firebase.google.com/docs/hosting/ +[Firebase]: https://firebase.google.com/docs/hosting/ "Firebase static hosting" [GitHub Pages]: https://pages.github.com/ [GitLab]: https://about.gitlab.com -[Go language]: http://golang.org/ "The Go Programming Language" -[GoDaddy]: https://www.godaddy.com/ +[GoDaddy]: https://www.godaddy.com/ "Godaddy.com Hosting" [Google Cloud Storage]: http://cloud.google.com/storage/ [Heroku]: https://www.heroku.com/ -[Hugo Performance Benchmark(@bep)]: https://github.com/bep/hugo-benchmark [Jekyll]: http://jekyllrb.com/ [Middleman]: https://middlemanapp.com/ [Nanoc]: http://nanoc.ws/ diff --git a/content/about-hugo/hugo-features.md b/content/about-hugo/hugo-features.md index a66616a77..84c753b70 100644 --- a/content/about-hugo/hugo-features.md +++ b/content/about-hugo/hugo-features.md @@ -14,7 +14,7 @@ notes: ## General -* Extremely fast build times (< .7 ms per page) +* [Extremely fast][] build times (< .7 ms per page) * Completely cross platform, with easy installation on [Mac OSX][], [Linux][], [Windows][], and more * Renders changes on the fly with [LiveReload][] as you develop * [Powerful theming][] @@ -55,12 +55,13 @@ See what's coming next in the [Hugo roadmap][]. ["Minutes to Read"]: /variables-and-params/ ["Wordcount"]: /variables-and-params/ -[Ace]: https://github.com/yosssi/ace +[Ace]: /templates/ace-templating/ [aliases]: /content-management/url-management/#aliases [Amber]: https://github.com/eknkc/amber [content summaries]: /content-management/content-summaries/ [content types]: /content-management/content-types/ [Disqus]: https://disqus.com/ +[Extremely fast]: https://github.com/bep/hugo-benchmark [front matter]: /content-management/front-matter/ [functions]: /functions/ [Golang]: http://golang.org/pkg/html/template/ diff --git a/content/content-management/_index.md b/content/content-management/_index.md index 04bc9e602..e9ceb7eb2 100644 --- a/content/content-management/_index.md +++ b/content/content-management/_index.md @@ -1,6 +1,6 @@ --- -title: "Introduction: Content Organization" -linktitle: "Introduction" +title: "Overview" +linktitle: "Overview" description: Content organization, summaries, archetypes, front matter, and supported formats. date: 2017-02-01 publishdate: 2017-02-01 diff --git a/content/content-management/archetypes.md b/content/content-management/archetypes.md index d51ab2eec..5809b1c4b 100644 --- a/content/content-management/archetypes.md +++ b/content/content-management/archetypes.md @@ -14,7 +14,7 @@ aliases: [] notes: --- -**Archetypes** are content files in the [archetypes directory][] of your project that contain pre-configured [front matter][] for your site's [content types][]. Archetypes facilitate consistent metadata in your website's content and allow content authors to quickly generate instances of a content type via the `hugo new` command. +**Archetypes** are content files in the [archetypes directory][] of your project that contain pre-configured [front matter][] for your website's [content types][]. Archetypes facilitate consistent metadata across your website content and allow content authors to quickly generate instances of a content type via the `hugo new` command. Hugo's generator assumes your working directory is the content folder at the root of your project. Hugo is able to infer the appropriate archetype by assuming the content type from the content section passed to the CLI command: @@ -31,10 +31,10 @@ hugo new posts/my-first-post.md {{% /input %}} {{% note "Override Content Type in a New File" %}} -To override the content type Hugo infers from `[content-section]`, you can include the `--kind` flag at the end of the `hugo new` command. +To override the content type Hugo infers from `[content-section]`, add the `--kind` flag to the end of the `hugo new` command. {{% /note %}} -If you were to run this command in a new site that does not contain any default or custom archetypes, Hugo will create the following file. +Running this command in a new site that does not have default or custom archetypes will create the following file: {{% output "content/posts/my-first-post.md" %}} ```toml @@ -45,15 +45,15 @@ title: my first post ``` {{% /output %}} -Note that if you do not already have a `posts` directory in `content`, Hugo will create both `content/posts/` and `content/posts/my-first-post.md`. +Note that if you do not already have a `posts` directory, Hugo will create both `content/posts/` and `content/posts/my-first-post.md`. -`date` and `title` are the key-values that ship with Hugo and are therefore included in *all* content files created with the Hugo CLI. `title` is generated from the new content's filename. `date` is generated in [RFC 3339 format][] by way of Golang's [`now()`][] function, which returns the current time. +`date` and `title` are the variables that ship with Hugo and are therefore included in *all* content files created with the Hugo CLI. `title` is generated from the new content's filename. `date` is generated in [RFC 3339 format][] by way of Golang's [`now()`][] function, which returns the current time. -Two key-values are often not enough for effective content management of larger websites. As such, Hugo provides a simple mechanism for extending these key-values through default and custom archetypes. +Two variables per content file are often not enough for effective content management of larger websites. Luckily, Hugo provides a simple mechanism for extending the number of variables through default and custom archetypes. ## Lookup Order for Archetypes -Similar to the lookup order for [templates in the layouts folder][], Hugo looks for a default file before falling back on the base/internal archetype. For the `my-first-post.md` example, Hugo looks for the new content's archetype file in the following order: +Similar to the lookup order for [templates in the `layouts` directory][], Hugo looks for a default file before falling back on the base/internal archetype. For the `my-first-post.md` example, Hugo looks for the new content's archetype file in the following order: 1. `archetypes/posts.md` 2. `archetypes/default.md` @@ -172,5 +172,5 @@ title = post from custom [front matter]: /content-management/front-matter/ [RFC 3339 format]: https://www.ietf.org/rfc/rfc3339.txt [taxonomies]: /content-management/taxonomies/ -[templates in the layouts folder]: /templates/base-templates-and-blocks/ +[templates in the `layouts` directory]: /templates/base-templates-and-blocks/ [templates]: /templates/ diff --git a/content/content-management/content-sections.md b/content/content-management/content-sections.md index ce55b7fbe..894a5c14d 100644 --- a/content/content-management/content-sections.md +++ b/content/content-management/content-sections.md @@ -5,7 +5,7 @@ description: date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 -tags: [] +tags: [lists,sections,content,types,organization] weight: 30 draft: false slug: @@ -13,4 +13,50 @@ aliases: [/content-management/sections,/content/sections/] notes: --- +## Content Organization + +Hugo believes that you organize your content with a purpose. The same structure that works to organize your source content is used to organize the rendered site (see [directory structure][]). + +Following this pattern, Hugo uses the top level of your content organization as the **content section**. + +The [example site][] used throughout the Hugo docs includes three sections: "authors," "events," and "posts": + +```bash +./content + |—–authors + |––_index.md + |––jon-doe.md + |––jane-doe.md + |––events + |––_index.md + |––event-1.md + |––event-2.md + |––event-3.md + |––posts + |--_index.md + |––post-1.md + |––post-2.md + |––post-3.md + |––post-4.md + |––post-5.md +``` + +## Content Section Lists + +Hugo will automatically create pages for each section root that list all of the content in that section. See [List and Section Page Templates][] for details on customizing the way these pages are rendered. + +As of Hugo v0.18, section pages can also have a content file and front matter. These section content files must be placed in their corresponding section folder and named `_index.md` in order for Hugo to correctly render the front matter and content. + +{{% warning "`index.md` vs `_index.md`" %}} +Hugo themes developed before v0.18 often used an `index.md` in a content section as a workaround to emulate the behavior of `_index.md`. The workaround works...*sometimes*. The order of page rendering can be unpredictable in Hugo. What works now may fail to render appropriately once you begin adding more content to your site. It is *strongly advised* to use the *preferred* content section organization and `_index.md`. +{{% /warning %}} + +## Content Section and Content Types + +By default, everything created within a section will use the content type that matches the section name. For example, Hugo will assume that `posts/post-1.md` has a `posts` content type and if using an [archetype][] will generate front matter according to `archetypes/posts.md`. + +[archetype]: /content-management/archetypes/ +[example site]: /getting-started/ +[directory structure]: /project-organization/directory-structure/ + diff --git a/content/content-management/content-types.md b/content/content-management/content-types.md index a9180a947..dc4639837 100644 --- a/content/content-management/content-types.md +++ b/content/content-management/content-types.md @@ -5,11 +5,22 @@ description: date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 -tags: [] +tags: [lists,sections,content,types,organization] categories: [] weight: 40 draft: false slug: aliases: [/content/types] notes: ---- \ No newline at end of file +--- + +Hugo provides full support for content types. A content type can have a unique set of metadata (i.e., [front matter][]) or customized [template][] and can be created by the `hugo new` command via content [archetypes][]. + + + + + + +[archetypes]: /content-management/archetypes/ +[front matter]: /content-management/front-matter/ +[template]: /templates/ \ No newline at end of file diff --git a/content/functions/GetPage.md b/content/functions/GetPage.md index 3857d58d1..2a017f3dd 100644 --- a/content/functions/GetPage.md +++ b/content/functions/GetPage.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/_index.md b/content/functions/_index.md index e2a76f261..e8ad3ca74 100644 --- a/content/functions/_index.md +++ b/content/functions/_index.md @@ -1,10 +1,10 @@ --- -title: Quick Reference -linktitle: Quick Reference +title: Overview +linktitle: Overview description: Comprehensive list of Hugo templating functions, including basic and advanced usage examples. -date: 2017-01-09 -publishdate: 2017-01-09 -lastmod: 2017-01-09 +date: 2017-02-01 +publishdate: 2017-02-01 +lastmod: 2017-02-01 tags: [functions,templating] weight: 01 draft: false diff --git a/content/functions/absLangURL.md b/content/functions/absLangURL.md index 1d4385e93..5925a3ee7 100644 --- a/content/functions/absLangURL.md +++ b/content/functions/absLangURL.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/absURL.md b/content/functions/absURL.md index f97464d7f..aefcea723 100644 --- a/content/functions/absURL.md +++ b/content/functions/absURL.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/add.md b/content/functions/add.md index 0cabfba04..9613a599b 100644 --- a/content/functions/add.md +++ b/content/functions/add.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/after.md b/content/functions/after.md index ea2c056b5..47cbe53c2 100644 --- a/content/functions/after.md +++ b/content/functions/after.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/apply.md b/content/functions/apply.md index 3a2c4a7af..e440c9adb 100644 --- a/content/functions/apply.md +++ b/content/functions/apply.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/base64Decode.md b/content/functions/base64Decode.md index 98318271d..d82a1b9b6 100644 --- a/content/functions/base64Decode.md +++ b/content/functions/base64Decode.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/base64Encode.md b/content/functions/base64Encode.md index 7c810a2a9..dab55cf00 100644 --- a/content/functions/base64Encode.md +++ b/content/functions/base64Encode.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/chomp.md b/content/functions/chomp.md index 7e8cdcc96..3396fae01 100644 --- a/content/functions/chomp.md +++ b/content/functions/chomp.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/countrunes.md b/content/functions/countrunes.md index 5f8508af4..823f76e18 100644 --- a/content/functions/countrunes.md +++ b/content/functions/countrunes.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/countwords.md b/content/functions/countwords.md index e0b1cae09..bd55dd637 100644 --- a/content/functions/countwords.md +++ b/content/functions/countwords.md @@ -14,4 +14,8 @@ layout: slug: aliases: [] notes: ---- \ No newline at end of file +--- + +## Example + +## Advanced Example diff --git a/content/functions/dateformat.md b/content/functions/dateformat.md index 2743cf19a..10a5f3b90 100644 --- a/content/functions/dateformat.md +++ b/content/functions/dateformat.md @@ -14,3 +14,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/default-function.md b/content/functions/default-function.md index 771cd0940..75c0352f5 100644 --- a/content/functions/default-function.md +++ b/content/functions/default-function.md @@ -13,3 +13,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/delimit.md b/content/functions/delimit.md index 1c9cbf629..822a30361 100644 --- a/content/functions/delimit.md +++ b/content/functions/delimit.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/dict.md b/content/functions/dict.md index a427f48a5..6f094ce5a 100644 --- a/content/functions/dict.md +++ b/content/functions/dict.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/div.md b/content/functions/div.md index f2bd900ef..3c198e4fc 100644 --- a/content/functions/div.md +++ b/content/functions/div.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/echoparam.md b/content/functions/echoparam.md index 2ddb08c5b..7511b00de 100644 --- a/content/functions/echoparam.md +++ b/content/functions/echoparam.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/emojify.md b/content/functions/emojify.md index 6ea9f5127..fb3f68581 100644 --- a/content/functions/emojify.md +++ b/content/functions/emojify.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/findRe.md b/content/functions/findRe.md index a15fe1493..c0249f389 100644 --- a/content/functions/findRe.md +++ b/content/functions/findRe.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/first.md b/content/functions/first.md index f93c9b7b5..1086ca08f 100644 --- a/content/functions/first.md +++ b/content/functions/first.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/getenv.md b/content/functions/getenv.md index ed493e97b..3c5dbb9c2 100644 --- a/content/functions/getenv.md +++ b/content/functions/getenv.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/hasPrefix.md b/content/functions/hasPrefix.md index 3304f0fba..93708f6e2 100644 --- a/content/functions/hasPrefix.md +++ b/content/functions/hasPrefix.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/highlight.md b/content/functions/highlight.md index 6567eae7f..0d256dd89 100644 --- a/content/functions/highlight.md +++ b/content/functions/highlight.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/htmlEscape.md b/content/functions/htmlEscape.md index cefd82d14..216e947ed 100644 --- a/content/functions/htmlEscape.md +++ b/content/functions/htmlEscape.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/htmlUnescape.md b/content/functions/htmlUnescape.md index 29b9ad701..1e2fef638 100644 --- a/content/functions/htmlUnescape.md +++ b/content/functions/htmlUnescape.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/humanize.md b/content/functions/humanize.md index cf42e2613..142ca03fa 100644 --- a/content/functions/humanize.md +++ b/content/functions/humanize.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/imageConfig.md b/content/functions/imageConfig.md index 2edf552b1..e285709b9 100644 --- a/content/functions/imageConfig.md +++ b/content/functions/imageConfig.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/in.md b/content/functions/in.md index cdf80bdff..6883f7ab1 100644 --- a/content/functions/in.md +++ b/content/functions/in.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/index-function.md b/content/functions/index-function.md index 89e7251bc..f7c8c81f3 100644 --- a/content/functions/index-function.md +++ b/content/functions/index-function.md @@ -16,4 +16,6 @@ aliases: [] notes: --- -Here is some content for the `index` function. +## Example + +## Advanced Example diff --git a/content/functions/int.md b/content/functions/int.md index 7f374cbba..64c45a7ec 100644 --- a/content/functions/int.md +++ b/content/functions/int.md @@ -16,3 +16,8 @@ aliases: [] tags: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/intersect.md b/content/functions/intersect.md index 1f07e8131..d66428351 100644 --- a/content/functions/intersect.md +++ b/content/functions/intersect.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/isset.md b/content/functions/isset.md index ba6250e7d..02d2a7521 100644 --- a/content/functions/isset.md +++ b/content/functions/isset.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/jsonify.md b/content/functions/jsonify.md index a9aea0cac..a77029cbb 100644 --- a/content/functions/jsonify.md +++ b/content/functions/jsonify.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/last.md b/content/functions/last.md index ef594127a..951f538b7 100644 --- a/content/functions/last.md +++ b/content/functions/last.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/lower.md b/content/functions/lower.md index 9777121bd..6ce38dc97 100644 --- a/content/functions/lower.md +++ b/content/functions/lower.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/markdownify.md b/content/functions/markdownify.md index 27cba30e9..b3af65d59 100644 --- a/content/functions/markdownify.md +++ b/content/functions/markdownify.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/md5.md b/content/functions/md5.md index b357690ee..55865b0c6 100644 --- a/content/functions/md5.md +++ b/content/functions/md5.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/mod.md b/content/functions/mod.md index ccef5d869..3538a75f0 100644 --- a/content/functions/mod.md +++ b/content/functions/mod.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/modBool.md b/content/functions/modBool.md index eb9d7e4a6..2cb875c18 100644 --- a/content/functions/modBool.md +++ b/content/functions/modBool.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/mul.md b/content/functions/mul.md index c80a73f98..a6e94f345 100644 --- a/content/functions/mul.md +++ b/content/functions/mul.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/partialCached.md b/content/functions/partialCached.md index 635ce2a26..b55378f5e 100644 --- a/content/functions/partialCached.md +++ b/content/functions/partialCached.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/plainify.md b/content/functions/plainify.md index cf9a5ebe0..632d21cb9 100644 --- a/content/functions/plainify.md +++ b/content/functions/plainify.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/pluralize.md b/content/functions/pluralize.md index ab5a17c74..d41ff8086 100644 --- a/content/functions/pluralize.md +++ b/content/functions/pluralize.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/printf.md b/content/functions/printf.md index 9c6807024..12c89c6c2 100644 --- a/content/functions/printf.md +++ b/content/functions/printf.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/querify.md b/content/functions/querify.md index e4aed3048..7731c3f0b 100644 --- a/content/functions/querify.md +++ b/content/functions/querify.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/range.md b/content/functions/range.md index 00ba65801..188737f2d 100644 --- a/content/functions/range.md +++ b/content/functions/range.md @@ -8,12 +8,15 @@ date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-01 categories: [fundamentals] -tags: [] +tags: [iteration] weight: draft: false -type: -layout: slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/readDir.md b/content/functions/readDir.md index 6fd67a9ee..35d41a502 100644 --- a/content/functions/readDir.md +++ b/content/functions/readDir.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/readFile.md b/content/functions/readFile.md index 888ae6ea6..5b67827bd 100644 --- a/content/functions/readFile.md +++ b/content/functions/readFile.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/rel.md b/content/functions/rel.md index 82dcfff14..344dd8cca 100644 --- a/content/functions/rel.md +++ b/content/functions/rel.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/relLangURL.md b/content/functions/relLangURL.md index a2d50b933..47c3401f8 100644 --- a/content/functions/relLangURL.md +++ b/content/functions/relLangURL.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/relURL.md b/content/functions/relURL.md index 8744349f3..41192edcc 100644 --- a/content/functions/relURL.md +++ b/content/functions/relURL.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/relref.md b/content/functions/relref.md index 08e474aa5..bae21cb47 100644 --- a/content/functions/relref.md +++ b/content/functions/relref.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/render.md b/content/functions/render.md index 838269c6a..7bf222301 100644 --- a/content/functions/render.md +++ b/content/functions/render.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/replace.md b/content/functions/replace.md index c72a9d177..dc4104b91 100644 --- a/content/functions/replace.md +++ b/content/functions/replace.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/safeCSS.md b/content/functions/safeCSS.md index ed8cf4d24..7f534cf1e 100644 --- a/content/functions/safeCSS.md +++ b/content/functions/safeCSS.md @@ -13,3 +13,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/safeHTML.md b/content/functions/safeHTML.md index 64f82de65..8b53161a0 100644 --- a/content/functions/safeHTML.md +++ b/content/functions/safeHTML.md @@ -13,3 +13,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/safeHTMLAttr.md b/content/functions/safeHTMLAttr.md index 7e428dadb..2ccc27794 100644 --- a/content/functions/safeHTMLAttr.md +++ b/content/functions/safeHTMLAttr.md @@ -13,3 +13,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/safeJS.md b/content/functions/safeJS.md index 1b0e9461c..c5bfa5b50 100644 --- a/content/functions/safeJS.md +++ b/content/functions/safeJS.md @@ -13,3 +13,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/safeURL.md b/content/functions/safeURL.md index a08c840b4..b2e409614 100644 --- a/content/functions/safeURL.md +++ b/content/functions/safeURL.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/scratch.md b/content/functions/scratch.md index fbd5d0e54..ecdb1fa32 100644 --- a/content/functions/scratch.md +++ b/content/functions/scratch.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/seq.md b/content/functions/seq.md index 01a56d0b2..91eb521b2 100644 --- a/content/functions/seq.md +++ b/content/functions/seq.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/sha1.md b/content/functions/sha1.md index a5590169e..37b96f2b4 100644 --- a/content/functions/sha1.md +++ b/content/functions/sha1.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/sha256.md b/content/functions/sha256.md index 3eee69ebe..ba0aba44d 100644 --- a/content/functions/sha256.md +++ b/content/functions/sha256.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/shuffle.md b/content/functions/shuffle.md index 58eef45bb..3c501aa93 100644 --- a/content/functions/shuffle.md +++ b/content/functions/shuffle.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/singularize.md b/content/functions/singularize.md index 206022f54..a778a3e43 100644 --- a/content/functions/singularize.md +++ b/content/functions/singularize.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/slice.md b/content/functions/slice.md index 342fb3dd9..3894094ca 100644 --- a/content/functions/slice.md +++ b/content/functions/slice.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/slicestr.md b/content/functions/slicestr.md index e0621be29..475575242 100644 --- a/content/functions/slicestr.md +++ b/content/functions/slicestr.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/sort.md b/content/functions/sort.md index 91aae7257..054272306 100644 --- a/content/functions/sort.md +++ b/content/functions/sort.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/split.md b/content/functions/split.md index 2ff0e82a9..a6ea4c79e 100644 --- a/content/functions/split.md +++ b/content/functions/split.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/string.md b/content/functions/string.md index ed7763ab4..c18ee1ff1 100644 --- a/content/functions/string.md +++ b/content/functions/string.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/sub.md b/content/functions/sub.md index cb8bad04b..c3353a5c3 100644 --- a/content/functions/sub.md +++ b/content/functions/sub.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/substr.md b/content/functions/substr.md index b9487e2da..9be57edd2 100644 --- a/content/functions/substr.md +++ b/content/functions/substr.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/time.md b/content/functions/time.md index 6c077af2a..6836b45a4 100644 --- a/content/functions/time.md +++ b/content/functions/time.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/title.md b/content/functions/title.md index c4260c880..9f9766fa7 100644 --- a/content/functions/title.md +++ b/content/functions/title.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/trim.md b/content/functions/trim.md index 20da13a2c..6f58090c5 100644 --- a/content/functions/trim.md +++ b/content/functions/trim.md @@ -15,3 +15,7 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example diff --git a/content/functions/upper.md b/content/functions/upper.md index ddc2973e7..26ab84094 100644 --- a/content/functions/upper.md +++ b/content/functions/upper.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/urlize.md b/content/functions/urlize.md index 2bb55def7..d59ed7d66 100644 --- a/content/functions/urlize.md +++ b/content/functions/urlize.md @@ -15,3 +15,8 @@ slug: aliases: [] notes: --- + +## Example + +## Advanced Example + diff --git a/content/functions/where.md b/content/functions/where.md index 3c35693df..dc9bb6455 100644 --- a/content/functions/where.md +++ b/content/functions/where.md @@ -16,4 +16,9 @@ aliases: [] notes: --- +## Example + +## Advanced Example + + Here is just some content testing for the where function. diff --git a/content/getting-started/_index.md b/content/getting-started/_index.md index 847dc1ab7..b1f5ed5dc 100644 --- a/content/getting-started/_index.md +++ b/content/getting-started/_index.md @@ -1,6 +1,6 @@ --- -title: How to Use the Hugo Docs -linktitle: How to Use the Hugo Docs +title: Using the Docs +linktitle: Using the Docs description: Quick start and guides for installing Hugo on your preferred operating system. date: 2017-02-01 publishdate: 2017-02-01 diff --git a/content/hosting-and-deployment/_index.md b/content/hosting-and-deployment/_index.md index ff9e58614..777cb8371 100644 --- a/content/hosting-and-deployment/_index.md +++ b/content/hosting-and-deployment/_index.md @@ -1,5 +1,5 @@ --- -title: Building Your Static Site +title: Overview linktitle: description: Site builds, automated deployments, and popular hosting solutions. date: 2016-11-01 diff --git a/content/migrating-to-hugo/_index.md b/content/migrating-to-hugo/_index.md deleted file mode 100644 index 876f69f9e..000000000 --- a/content/migrating-to-hugo/_index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Migrating to Hugo -linktitle: -description: Tools and tutorials for migrating to Hugo from other platforms or generators (eg, Wordpress, Jekyll). -date: 2017-02-01 -publishdate: 2017-02-01 -lastmod: 2017-02-01 -tags: [] -categories: [] -weight: 01 -draft: false -slug: -aliases: [] -notes: ---- - - - diff --git a/content/news-and-articles/_index.md b/content/news-and-articles/_index.md index a95dcebba..d78415283 100644 --- a/content/news-and-articles/_index.md +++ b/content/news-and-articles/_index.md @@ -1,5 +1,5 @@ --- -title: News and Articles +title: Overview linktitle: description: Articles where Hugo is featured, as well as news and updates on the project itself. date: 2017-02-01 diff --git a/content/project-organization/_index.md b/content/project-organization/_index.md index c4ee5bf40..04a8e1bc2 100644 --- a/content/project-organization/_index.md +++ b/content/project-organization/_index.md @@ -1,5 +1,5 @@ --- -title: New Website Scaffolding +title: Overview linktitle: description: Scaffolding new projects, configuration, and source organization. date: 2016-11-01 diff --git a/content/project-organization/directory-structure.md b/content/project-organization/directory-structure.md index 2fc593985..e53197a10 100644 --- a/content/project-organization/directory-structure.md +++ b/content/project-organization/directory-structure.md @@ -5,6 +5,8 @@ description: Explanation of the directory structure in a typical Hugo project an date: 2017-01-02 publishdate: 2017-01-02 lastmod: 2017-01-02 +categories: [project organization] +tags: [source, organization, directories] weight: 10 draft: false slug: diff --git a/content/templates/_index.md b/content/templates/_index.md index ad3c515ea..4c60111c6 100644 --- a/content/templates/_index.md +++ b/content/templates/_index.md @@ -1,6 +1,6 @@ --- -title: Introduction to Hugo Templating -linktitle: +title: Overview +linktitle: Overview description: Golang templating, template types and lookup order, shortcodes, and data. date: 2017-02-01 publishdate: 2017-02-01 diff --git a/content/templates/list-and-section-page-templates.md b/content/templates/list-and-section-page-templates.md new file mode 100644 index 000000000..3bc454783 --- /dev/null +++ b/content/templates/list-and-section-page-templates.md @@ -0,0 +1,16 @@ +--- +title: List and Section Page Templates +linktitle: List and Section Page Templates +description: +date: 2017-02-01 +publishdate: 2017-02-01 +lastmod: 2017-02-01 +weight: +tags: [lists,sections] +draft: false +slug: +aliases:[/templates/list/] +notes: +--- + +## Lookup Order for List and Section Page Templates \ No newline at end of file diff --git a/content/templates/list-page-template.md b/content/templates/list-page-template.md deleted file mode 100644 index f4d8e2cb5..000000000 --- a/content/templates/list-page-template.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: List Page Templates -linktitle: -description: -date: 2017-02-01 -publishdate: 2017-02-01 -lastmod: 2017-02-01 -weight: -tags: [] -draft: false -slug: -aliases: -notes: ---- - -## Lookup Order for List and Section Pages \ No newline at end of file diff --git a/content/templates/single-page-template.md b/content/templates/single-page-templates.md similarity index 100% rename from content/templates/single-page-template.md rename to content/templates/single-page-templates.md diff --git a/themes/hugodocs/layouts/_default/section.html b/themes/hugodocs/layouts/_default/section.html index bda670773..7024ccae2 100644 --- a/themes/hugodocs/layouts/_default/section.html +++ b/themes/hugodocs/layouts/_default/section.html @@ -2,10 +2,8 @@ {{$title := .Title}}
-

{{with .LinkTitle}}{{ . |markdownify}}{{else}}{{ .Title | markdownify }}{{end}}

-
- -
+

Icon for the {{.Section}} section.{{with .LinkTitle}}{{ . |markdownify}}{{else}}{{ .Title | markdownify }}{{end}}

+ {{partial "content-header-links.html" . }} {{with .Params.tags}}