From e34a358e391437f151951f401bd7cfdb72258b26 Mon Sep 17 00:00:00 2001
From: Ryan Watters <watters.ryan@gmail.com>
Date: Mon, 20 Feb 2017 23:57:11 -0600
Subject: [PATCH] Add first part of command section

---
 config.toml                                   |  3 +-
 content/command/_index.md                     | 14 +++
 content/content-management/shortcodes.md      | 17 ++--
 content/contribute-to-hugo/_index.md          |  5 +-
 .../contribute-to-hugo-development.md         | 86 ++++++++++++++-----
 content/functions/index-function.md           |  2 -
 content/getting-started/quick-start.md        |  4 +-
 .../layouts/partials/site-header.html         |  2 +-
 themes/hugodocs/layouts/section/commands.html |  8 ++
 themes/hugodocs/pipeline/scss/_temp.scss      |  8 +-
 .../pipeline/scss/components/_anchors.scss    | 28 +++++-
 11 files changed, 131 insertions(+), 46 deletions(-)
 create mode 100644 content/command/_index.md
 create mode 100644 themes/hugodocs/layouts/section/commands.html

diff --git a/config.toml b/config.toml
index 7521b730c..03a591e9f 100644
--- a/config.toml
+++ b/config.toml
@@ -55,10 +55,9 @@ watch = true
 
 #CUSTOM PARAMS
 [params]
-  sitesubtitle = ""
 	organizationname = ""
-  copyrightline = ""
   sitedescription = ""
+  release = "0.18.1"
   # Add GA Tracking Code Here. This leverages a built-in (ie, "internal") partial from HUGO: https://gohugo.io/extras/analytics#configuring-google-analytics
   googleanalyticstrackingcode = ""
   ## Critical Render Path. If true, site style will be embedded in a <style> tag in each html <head> as part of Gulp Build. False puts a typical <link> to the stylesheet in <head>>
diff --git a/content/command/_index.md b/content/command/_index.md
new file mode 100644
index 000000000..2cd6860bb
--- /dev/null
+++ b/content/command/_index.md
@@ -0,0 +1,14 @@
+---
+title: Command Line Reference
+linktitle: CLI
+description: Comprehensive list of Hugo templating functions, including basic and advanced usage examples.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+tags: [functions,templating]
+weight: 01
+draft: false
+slug:
+aliases: []
+notesforauthors:
+---
\ No newline at end of file
diff --git a/content/content-management/shortcodes.md b/content/content-management/shortcodes.md
index 874efa356..7318a97bf 100644
--- a/content/content-management/shortcodes.md
+++ b/content/content-management/shortcodes.md
@@ -14,23 +14,19 @@ aliases: [/extras/shortcodes/]
 toc: true
 ---
 
-Hugo loves Markdown because of its simple content format, but there are times when markdown falls short. Often, content authors fall back on adding raw HTML (e.g., video `<iframes>`) to markdown content. We think blocks of raw HTML contradict the beautiful simplicity of markdown's syntax.
+Hugo loves Markdown because of its simple content format, but there are times when markdown falls short. Often, content authors are forced to add raw HTML (e.g., video `<iframes>`) to markdown content. We think this contradicts the beautiful simplicity of markdown's syntax.
 
 Hugo created **shortcodes** to circumvent these limitations.
 
-A shortcode is a simple snippet inside a content file that Hugo will render using a predefined template. Note that shortcodes will not work in template files---if you need the type of drop-in functionality that shortcodes provide but in a template, you most likely want a [partial template][partialtemplatespage] instead.
+A shortcode is a simple snippet inside a content file that Hugo will render using a predefined template. Note that shortcodes will not work in template files---if you need the type of drop-in functionality that shortcodes provide but in a template, you most likely want a [partial template][partials] instead.
 
 In addition to cleaner markdown, shortcodes can be updated any time to reflect new classes, techniques, or standards. At the point of site generation, Hugo shortcodes will easily merge in your changes. You avoid a possibly complicated search and replace operation.
 
 ## Using Shortcodes
 
-In your content files, a shortcode can be called by using the `{{%/* shortcodename parameters*/%}}` form. Shortcode parameters are space delimited. Parameters with internal spaces can be quoted.
+In your content files, a shortcode can be called by calling `{{%/* shortcodename parameters*/%}}`. Shortcode parameters are space delimited, and parameters with internal spaces can be quoted.
 
-The first word is always the name of the shortcode. Parameters follow the name.
-Depending upon how the shortcode is defined, the parameters may be named,
-positional or both (although you can't mixed parameter types in a single call).
-The format for named parameters models that of HTML with the format
-`name="value"`.
+The first word in the shortcode declaration is always the name of the shortcode. Parameters follow the name. Depending upon how the shortcode is defined, the parameters may be named, positional or both (although you can't mixed parameter types in a single call). The format for named parameters models that of HTML with the format `name="value"`.
 
 Some shortcodes use or require closing shortcodes. Like HTML, the opening and closing shortcodes match (name only) with the closing declaration prepended with a slash.
 
@@ -120,8 +116,7 @@ If the gist contains several files and you want to quote just one of them, you c
 
 ### `highlight`
 
-This shortcode will convert the source code provided into syntax highlighted
-HTML. Read more on [highlighting](/extras/highlighting/). `highlight` takes exactly one required parameter of _language_ and requires a closing shortcode.
+This shortcode will convert the source code provided into syntax-highlighted HTML. Read more on [highlighting](/developer-tools/syntax-highlighting/). `highlight` takes exactly one required parameter of _language_ and requires a closing shortcode.
 
 #### Example `highlight` Input
 
@@ -269,7 +264,7 @@ To learn more about creating your own shortcode templates, see the [shortcode te
 [`figure` shortcode]: #figure
 [Instagram]: https://www.instagram.com/
 [pagevariables]: /variables-and-params/page-variables/
-[partialtemplatespage]: /templates/partials-templates/
+[partials]: /templates/partials-templates/
 [Pygments]: http://pygments.org/
 [projectorganizationsection]: /project-organization/directory-structure/
 [shortcode template documentation]: /templates/shortcode-templates/
diff --git a/content/contribute-to-hugo/_index.md b/content/contribute-to-hugo/_index.md
index e540d19ec..316eba261 100644
--- a/content/contribute-to-hugo/_index.md
+++ b/content/contribute-to-hugo/_index.md
@@ -12,9 +12,8 @@ draft: false
 slug:
 aliases: [/tutorials/how-to-contribute-to-hugo/]
 toc: false
-notesforauthors:
 ---
 
-Hugo will always be open source and therefore really heavily on the enthusiasm and participation of the open-source community. Hugo needs your support in both its development and documentation.
+Hugo relies heavily on the enthusiasm and participation of the open-source community. We need your support in both its development and documentation.
 
-The formal contribution guidelines for Hugo are [detailed in a `CONTRIBUTING.md`](https://github.com/spf13/hugo/blob/master/CONTRIBUTING.md) in the Hugo source repository on GitHub.
\ No newline at end of file
+Hugo's contribution guidelines are [detailed in a `CONTRIBUTING.md`](https://github.com/spf13/hugo/blob/master/CONTRIBUTING.md) in the Hugo source repository on GitHub.
\ No newline at end of file
diff --git a/content/contribute-to-hugo/contribute-to-hugo-development.md b/content/contribute-to-hugo/contribute-to-hugo-development.md
index 6fa0dfee2..0f9cf78f0 100644
--- a/content/contribute-to-hugo/contribute-to-hugo-development.md
+++ b/content/contribute-to-hugo/contribute-to-hugo-development.md
@@ -7,6 +7,7 @@ publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [contribute to hugo]
 tags: [dev,open source]
+authors: [digitalcraftsman]
 weight: 10
 draft: false
 aliases: [/contribute-to-hugo/contribute-to-hugo-development/]
@@ -17,35 +18,64 @@ notesforauthors:
 
 ## Introduction
 
-Hugo is an open-source project and lives by the work of its [contributors](https://github.com/spf13/hugo/graphs/contributors). Help to make Hugo even more awesome. There are plenty of [open issues](https://github.com/spf13/hugo/issues) on GitHub, and we need your help.
+Hugo is an open-source project and lives by the work of its [contributors][]. There are plenty of [open issues][], and we need your help to make Hugo even more awesome.
 
-This tutorial is intended for people who are new to Git, GitHub or open source projects in general. It should help to overcome most of the barriers that newcomers encounter. It describes step by step what you need to do.
+## Assumptions
 
-For any kind of questions please take a look at the [Hugo Discussion forum](https://discuss.gohugo.io/).
+* You are new to Git or open-source projects in general
+* You are a fan of Hugo and enthusiastic about contributing to the project
 
-## Install Go
+This contribution guide takes a step-by-step approach in hopes of helping newcomers.
 
-The installation of Go should take only a few minutes. [Download](https://golang.org/dl/) the latest stable version of Go and follow the official [installation guide](https://golang.org/doc/install).
+{{% note "Additional Questions?" %}}
+If you're struggling at any point in this contribution guide, reach out to Hugo community in [Hugo's Discussion forum](https://discuss.gohugo.io).
+{{% /note %}}
 
-Let's confirm the correct installation of Go. Open a terminal (or command line under Windows). Execute `go version` and you should see the version number of your Go installation. Next, make sure that you setup the `GOPATH` as described in the installation guide.
+### Installing Golang
 
-You can print the `GOPATH` with `echo $GOPATH`. You should see a non-empty string containing a valid path to your Go workspace.
+The installation of Go should take only a few minutes. You have more than one option to get Go up and running on your machine.
 
-### GVM as alternative
+## Installing Go From Source
 
-More experienced users can use the [Go Version Manager](https://github.com/moovweb/gvm), or GVM for short. It allows you to switch between different Go versions *on the same machine*. Probably you don't need this feature. But you can easily upgrade to a new released Go version with a few commands.
+[Download the latest stable version of Go][downloadgo] and follow the official [Golang installation guide][installgo].
 
-This is handy if you follow the developement of Hugo over a longer period of time. Future versions of Hugo will usually be compiled with the latest version of Go. Sooner or later you have to upgrade if you want to keep up.
+Once you're finished installing Go, let's confirm everything is working correctly. Open a terminal---or command line under Windows--and type the following:
+
+```bash
+`go version`
+```
+
+You should see something similar to the following written to the console. Note that the version here reflects the most recent version of Go as of the last update for this page:
+
+```bash
+go version go1.8 darwin/amd64
+```
+
+Next, make sure that you set up your `GOPATH` [as described in the installation guide][setupgopath].
+
+You can print the `GOPATH` with `echo $GOPATH`. You should see a non-empty string containing a valid path to your Go workspace; .e.g.:
+
+```bash
+/Users/<yourusername>/Code/go
+```
+
+### Installing Go with Homebrew
 
 
-## Create an account on GitHub
+
+### Install Go GVM
+
+More experienced users can use the [Go Version Manager][gvm] (GVM). GVM allows you to switch between different Go versions *on the same machine*. If you're a beginner, you probably don't need this feature. However, GVM makes it easy to upgrade to a new released Go version with just a few commands.
+
+GVM comes in especially handy if you follow the development of Hugo over a longer period of time. Future versions of Hugo will usually be compiled with the latest version of Go. Sooner or later, you will have to upgrade if you want to keep up.
+
+## Creating a GitHub Account
 
 If you're going to contribute code, you'll need to have an account on GitHub. Go to [www.github.com/join](https://github.com/join) and set up a personal account.
 
+## Installing Git on Your System
 
-## Install Git on your system
-
-You will need to install Git. This tutorial assumes basic knowledge about Git. Refer to this excellent [Git book](https://git-scm.com/) if you are not sure where to begin. The used terminology will be explained with annotations.
+You will need to have Git installed on your computer to contribute to Hugo development. Teaching git is outside the scope of the Hugo docs, but if you're looking for an excellent reference to learn the basics of Git, we recommend the [Git book](https://git-scm.com/) if you are not sure where to begin. The used terminology will be explained with annotations.
 
 Git is a [version control system](https://en.wikipedia.org/wiki/Version_control) to track the changes of source code. Hugo depends on smaller third-party packages that are used to extend the functionality. We use them because we don't want to reinvent the wheel.
 
@@ -59,17 +89,17 @@ Finally, check again with `git version` if Git was installed successfully.
 
 There are several [GUI clients](https://git-scm.com/downloads/guis) that help you to operate Git. Not all are available for all operating systems and maybe differ in their usage. Thus, so we will use the command line since the commands are everywhere the same.
 
-### Install Hub on your system (optional)
+### Install Hub on Your System (optional)
 
 Hub is a great tool for working with GitHub. The main site for it is [www.hub.github.com](https://hub.github.com/). Feel free to install this little Git wrapper.
 
-On a Mac, install Hub using brew:
+On a Mac, you can install [Hub](https://github.com/github/hub) using [Homebrew](https://brew.sh):
 
 ```sh
 brew install hub
 ```
 
-Create an alias (in Bash) so that typing git actually runs Hub:
+Now we'll create an [alias in Bash](http://tldp.org/LDP/abs/html/aliases.html) so that typing `git` actually runs `Hub`:
 
 ```sh
 echo "alias git='hub'" >> ~/.bash_profile
@@ -156,8 +186,7 @@ origin  https://github.com/spf13/hugo (fetch)
 origin  https://github.com/spf13/hugo (push)
 ```
 
-
-## The contribution workflow
+## The Hugo Git Contribution Workflow
 
 ### Create a new branch
 
@@ -180,7 +209,7 @@ You can check on which branch your are with `git branch`. You should see a list
 
 ### Contributing to the documentation
 
-Perhaps you want to start contributing to the docs. Then you can ignore most of the following steps. You can find the documentation within the cloned repository in the subfolder `docs`. Change the directory with `cd docs`. [Install the latest release][]. Or read on and build Hugo from source.
+Perhaps you want to start contributing to the docs. Then you can ignore most of the following steps. You can find the documentation within the cloned repository in the subfolder `docs`. Change the directory with `cd docs`. [Install the latest release][releases]. Or read on and build Hugo from source.
 
 You can start Hugo's built-in server via `hugo server`. Browse the documentation by entering [http://localhost:1313](http://localhost:1313) in the address bar of your browser. The server automatically updates the page if you change its content.
 
@@ -345,4 +374,19 @@ If you have questions leave a comment in the pull request. We are willing to ass
 
 Thank you for reading this tutorial. Hopefully, we see you again on GitHub. There are plenty of [open issues](https://github.com/spf13/hugo/issues) on GitHub. Feel free to open an issue if you think you found a bug or you have a new idea to improve Hugo. We are happy to hear from you.
 
-[Install the latest release]: /getting-started/
+## Additional References for Learning Git
+
+* [Codecademy's Free "Learn Git" Course][codecademy]
+* [Code School and GitHub's Free "Try Git" Tutorial][trygit]
+*
+
+
+[codecademy]: https://www.codecademy.com/learn/learn-git
+[contributors]: https://github.com/spf13/hugo/graphs/contributors
+[downloadgo]: https://golang.org/dl/
+[gvm]: https://github.com/moovweb/gvm
+[installgo]: https://golang.org/doc/install
+[releases]: /getting-started/
+[setupgopath]: https://golang.org/doc/code.html#Workspaces
+[open issues]: https://github.com/spf13/hugo/issues
+[trygit]: https://try.github.io/levels/1/challenges/1
\ No newline at end of file
diff --git a/content/functions/index-function.md b/content/functions/index-function.md
index 85c6c16bb..25312ef29 100644
--- a/content/functions/index-function.md
+++ b/content/functions/index-function.md
@@ -19,5 +19,3 @@ From the godocs:
 > Returns the result of indexing its first argument by the following arguments. Thus "index x 1 2 3" is, in Go syntax, x[1][2][3]. Each indexed item must be a map, slice, or array.
 
 ## Example
-
-## Advanced Example
diff --git a/content/getting-started/quick-start.md b/content/getting-started/quick-start.md
index bf2d028c4..5593ff56b 100644
--- a/content/getting-started/quick-start.md
+++ b/content/getting-started/quick-start.md
@@ -323,7 +323,7 @@ Our website is now using the `bleak` theme at <http://localhost:1313>, which sho
 
 ![Screenshot of the Quick Start website's homepage running with the Bleak Hugo theme.](/images/quickstart/bookshelf-bleak-theme.png)
 
-## Step 7. Update `config.toml` and Watch LiveReload in Action
+## Step 7. Update Your Configuration
 
 Kill the Hugo server if you are still running it with the Bleak theme, and then restart the server with the `robust` theme. We will use Robust for the duration of this Quick Start:
 
@@ -511,7 +511,7 @@ Now, commenting will be enabled in your blog.
 
 ![](/images/quickstart/bookshelf-disqus.png)
 
-## Step 11. Generate Your Website with `hugo`
+## Step 11. Build Your Website with `hugo`
 
 To generate a website that can be deployed to GitHub pages, we first need to change the `baseURL` in our configuration as follows:
 
diff --git a/themes/hugodocs/layouts/partials/site-header.html b/themes/hugodocs/layouts/partials/site-header.html
index e11149971..e962351a2 100644
--- a/themes/hugodocs/layouts/partials/site-header.html
+++ b/themes/hugodocs/layouts/partials/site-header.html
@@ -1,4 +1,4 @@
-{{$version := .Hugo.Version}}
+{{$version := .Site.Params.release }}
 {{$base := .Site.BaseURL}}
 <header id="site-header" class="site-header">
   <div class="hugo-meta" title="Hugo version {{$version}}">
diff --git a/themes/hugodocs/layouts/section/commands.html b/themes/hugodocs/layouts/section/commands.html
new file mode 100644
index 000000000..3a5be83d8
--- /dev/null
+++ b/themes/hugodocs/layouts/section/commands.html
@@ -0,0 +1,8 @@
+{{ define "main" }}
+<h1>Hugo Commands</h1>
+{{.Content}}
+{{ range .Data.Pages }}
+<li><a href="{{ .URL }}">{{ .Title }}</a></li>
+{{ end }}
+</ul>
+{{ end }}
\ No newline at end of file
diff --git a/themes/hugodocs/pipeline/scss/_temp.scss b/themes/hugodocs/pipeline/scss/_temp.scss
index b3651d6ba..a852c1b81 100644
--- a/themes/hugodocs/pipeline/scss/_temp.scss
+++ b/themes/hugodocs/pipeline/scss/_temp.scss
@@ -11,4 +11,10 @@
 	padding:6px;
 	z-index:9999;
 	overflow:visible;
-}
\ No newline at end of file
+}
+
+// .twitter-tweet-rendered {
+// 	display:block;
+// 	margin-left:auto;
+// 	margin-right:auto;
+// }
\ No newline at end of file
diff --git a/themes/hugodocs/pipeline/scss/components/_anchors.scss b/themes/hugodocs/pipeline/scss/components/_anchors.scss
index 40d4ec257..94332f977 100644
--- a/themes/hugodocs/pipeline/scss/components/_anchors.scss
+++ b/themes/hugodocs/pipeline/scss/components/_anchors.scss
@@ -85,15 +85,37 @@ a.heading-link {
   position: absolute;
   display: inline;
   top: .4em;
-  right:0px;
+  right: 0px;
   &:before,
   &:after {
     display: none;
   }
-  @include MQ(M){
-    left:-1.5em;
+  @include MQ(M) {
+    left: -1.5em;
   }
   &:hover {
     color: $default-anchor-underline-color;
   }
 }
+
+// .body-copy {
+//   a[href*="github.com"]:after {
+//     content: '\f09b';
+//     font-family: 'fontello';
+//     color: inherit;
+//     display: inline-block;
+//     margin-left: .1em;
+//     @include size(1em);
+//     margin-right: .2em;
+//     text-align: center;
+//   }
+//   a[href*="discuss.gohugo.io"]:after {
+//     content: '\f03d';
+//     display: inline-block;
+//     font-family: 'fontello';
+//     margin-left: .1em;
+//     @include size(1em);
+//     margin-right: .2em;
+//     text-align: center;
+//   }
+// }