Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs'

```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925

61 files changed, 1077 insertions, 0 deletions

diff --git a/docs/static/apple-touch-icon.png b/docs/static/apple-touch-icon.png
new file mode 100644
index 000000000..50e23ce1d
--- /dev/null
+++ b/docs/static/apple-touch-icon.png
diff --git a/docs/static/css/hugofont.css b/docs/static/css/hugofont.css
new file mode 100644
index 000000000..09d6ce070
--- /dev/null
+++ b/docs/static/css/hugofont.css
@@ -0,0 +1,184 @@
+@font-face {
+	font-family: 'hugo';
+	src:url('../fonts/hugo.eot');
+	src:url('../fonts/hugo.eot?#iefix') format('embedded-opentype'),
+		url('../fonts/hugo.woff') format('woff'),
+		url('../fonts/hugo.ttf') format('truetype'),
+		url('../fonts/hugo.svg#hugo') format('svg');
+	font-weight: normal;
+	font-style: normal;
+}
+
+[class^="icon-"], [class*=" icon-"] {
+	font-family: 'hugo';
+	speak: none;
+	font-style: normal;
+	font-weight: normal;
+	font-variant: normal;
+	text-transform: none;
+	line-height: 1;
+
+	/* Better Font Rendering =========== */
+	-webkit-font-smoothing: antialiased;
+	-moz-osx-font-smoothing: grayscale;
+}
+
+.icon-home:before {
+	content: "\21";
+}
+.icon-html5:before {
+	content: "\23";
+}
+.icon-css3:before {
+	content: "\24";
+}
+.icon-console:before {
+	content: "\25";
+}
+.icon-link:before {
+	content: "\26";
+}
+.icon-fire:before {
+	content: "\28";
+}
+.icon-check-alt:before {
+	content: "\29";
+}
+.icon-hugo_serif:before {
+	content: "\e600";
+}
+.icon-x-altx-alt:before {
+	content: "\2a";
+}
+.icon-circlestar:before {
+	content: "\2b";
+}
+.icon-file-css:before {
+	content: "\2c";
+}
+.icon-radio-checked:before {
+	content: "\2e";
+}
+.icon-quote:before {
+	content: "\44";
+}
+.icon-airplane2:before {
+	content: "\45";
+}
+.icon-heart:before {
+	content: "\46";
+}
+.icon-rocket:before {
+	content: "\47";
+}
+.icon-house:before {
+	content: "\48";
+}
+.icon-arrow-right:before {
+	content: "\e001";
+}
+.icon-arrow-left:before {
+	content: "\e002";
+}
+.icon-flow-branch:before {
+	content: "\e004";
+}
+.icon-pen:before {
+	content: "\e005";
+}
+.icon-idea:before {
+	content: "\3b";
+}
+.icon-gears:before {
+	content: "\3c";
+}
+.icon-talking:before {
+	content: "\3d";
+}
+.icon-tag:before {
+	content: "\3e";
+}
+.icon-rocket2:before {
+	content: "\3f";
+}
+.icon-octocat:before {
+	content: "\41";
+}
+.icon-announce:before {
+	content: "\42";
+}
+.icon-edit:before {
+	content: "\43";
+}
+.icon-power-cord:before {
+	content: "\50";
+}
+.icon-apple:before {
+	content: "\51";
+}
+.icon-windows8:before {
+	content: "\52";
+}
+.icon-tux:before {
+	content: "\53";
+}
+.icon-file-xml:before {
+	content: "\54";
+}
+.icon-fork:before {
+	content: "\55";
+}
+.icon-arrow-down:before {
+	content: "\56";
+}
+.icon-pacman:before {
+	content: "\e000";
+}
+.icon-embed:before {
+	content: "\2f";
+}
+.icon-code:before {
+	content: "\30";
+}
+.icon-cc:before {
+	content: "\31";
+}
+.icon-cc-by:before {
+	content: "\32";
+}
+.icon-cc-nc:before {
+	content: "\33";
+}
+.icon-beaker-alt:before {
+	content: "\39";
+}
+.icon-w3c:before {
+	content: "\3a";
+}
+.icon-bolt:before {
+	content: "\49";
+}
+.icon-flow-tree:before {
+	content: "\4a";
+}
+.icon-twitter:before {
+	content: "\4b";
+}
+.icon-beaker:before {
+	content: "\4c";
+}
+.icon-images:before {
+	content: "\4d";
+}
+.icon-bubbles:before {
+	content: "\4e";
+}
+.icon-meter2:before {
+	content: "\4f";
+}
+.icon-hugo_sans:before {
+	content: "\68";
+}
+.icon-spf13:before {
+	content: "\27";
+}
diff --git a/docs/static/css/style.css b/docs/static/css/style.css
new file mode 100644
index 000000000..312c247c9
--- /dev/null
+++ b/docs/static/css/style.css
@@ -0,0 +1,684 @@
+/* Import fonts */
+@import url(//fonts.googleapis.com/css?family=Lato:300,400,700,900,300italic,400italic,700italic,900italic);
+
+/* ******************************
+ For the github btn
+****************************** */
+
+.github-btn {
+  font-size: 11px;
+}
+.github-btn,
+.github-btn .btn {
+  font-weight: bold;
+}
+.github-btn .btn-default {
+    text-shadow: 0 1px 0 #fff;
+    background-image: -webkit-gradient(linear, left 0%, left 100%, from(#ffffff), to(#e0e0e0));
+    background-image: -webkit-linear-gradient(top, #ffffff, 0%, #e0e0e0, 100%);
+    background-image: -moz-linear-gradient(top, #ffffff 0%, #e0e0e0 100%);
+    background-image: linear-gradient(to bottom, #ffffff 0%, #e0e0e0 100%);
+    background-repeat: repeat-x;
+    border-color: #dbdbdb;
+    border-color: #ccc;
+    filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffffff', endColorstr='#ffe0e0e0', GradientType=0);
+}
+
+.github-btn .btn-default:hover, .github-btn .btn-default:focus {
+    background-color: #e0e0e0;
+    background-position: 0 -15px;
+    color: #333;
+    border-color: #adadad;
+}
+
+.nav-github {
+    width: 325px;
+}
+ .nav-github > span {
+     padding-right: 0.5em;
+ }
+
+ .icon-github {
+    display: inline-block;
+    font-family: FontAwesome;
+    font-style: normal;
+    font-weight: normal;
+    line-height: 1;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+ }
+
+ .github-watchers .icon-github:before{
+      content: "\f005";
+ }
+
+ .github-forks .icon-github:before{
+      content: "\f126";
+ }
+
+.gh-count{
+  padding: 2px 5px 3px 4px;
+  color: #555;
+  text-decoration: none;
+  text-shadow:0 1px 0 #fff;
+  white-space:nowrap;
+  cursor:pointer;
+  border-radius:3px;
+  position:relative;
+  display:none;
+  margin-left:4px;
+  background-color:#fafafa;
+  border:1px solid #d4d4d4;
+}
+
+.gh-count:hover,.gh-count:focus{color:#4183c4;text-decoration: none;}
+.gh-count:before,.gh-count:after{content:' ';position:absolute;display:inline-block;width:0;height:0;border-color:transparent;border-style:solid}
+.gh-count:before{top:50%;left:-3px;margin-top:-4px;border-width:4px 4px 4px 0;border-right-color:#fafafa}
+.gh-count:after{top:50%;left:-4px;z-index:-1;margin-top:-5px;border-width:5px 5px 5px 0;border-right-color:#d4d4d4}
+
+thead {
+    font-weight: bold;
+}
+
+table {
+    width: 100%;
+}
+
+
+h1, h2, h3 {
+    margin-top: .8em;
+    margin-bottom: .7em;
+}
+
+pre code {
+    font-size: 15px !important;
+    font-family: Menlo, Consolas, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', Monaco, 'Droid Sans Mono', monospace;
+}
+
+body {
+    color: #353b44;
+    background: #edece4;
+    font-family: 'Lato', sans-serif;
+    padding: 0px !important;
+    margin: 0px !important;
+    font-size: 16px !important;
+    font-weight: 400;
+}
+
+h2,h3,h4,h5{
+    font-weight: 700;
+}
+
+
+h1[id]:before, h2[id]:before, h3[id]:before, h4[id]:before, h5[id]:before {
+    display: block;
+    content: " ";
+    margin-top: -75px;
+    height: 75px;
+    visibility: hidden;
+}
+
+label{
+    font-weight: 400;
+}
+
+.sidebar-menu .fa {
+    width: 30px;
+    text-align: center;
+}
+
+a, a:hover, a:focus {
+    text-decoration: none;
+    outline: none;
+    outline: 0;
+}
+
+img {
+    max-width: 100%;
+    height: auto;
+}
+
+.panel-body a {
+    line-height: 1.1;
+    display: inline-block;
+}
+.panel-body a:after {
+  display: block;
+  content: "";
+  height: 1px;
+  width: 0%;
+  background-color: #ff4088;
+  -webkit-transition: width 0.5s ease;
+  -moz-transition: width 0.5s ease;
+  -ms-transition: width 0.5s ease;
+  transition: width 0.5s ease;
+}
+
+.panel-body a:hover:after, .panel-body a:focus:after {
+    width: 100%;
+}
+
+input:focus, textarea:focus { outline: none; }
+*:focus {outline: none;}
+::selection {
+    background: #ff4088;
+    color: #fff;
+}
+::-moz-selection {
+    background: #ff4088;
+    color: #fff;
+}
+
+#container {
+    width: 100%;
+    height: 100%;
+}
+
+/*sidebar navigation*/
+
+#sidebar {
+    width: 214px;
+    height: 100%;
+    position: fixed;
+    background: #ffffff;
+    overflow-y: auto;
+}
+
+
+ul.sidebar-menu , ul.sidebar-menu li ul.sub{
+    margin: -2px 0 0;
+    padding: 0;
+}
+
+ul.sidebar-menu {
+    margin-top: 60px;
+}
+
+#sidebar > ul > li > ul.sub {
+    display: none;
+}
+
+#sidebar > ul > li.active > ul.sub, #sidebar > ul > li > ul.sub > li > a {
+    display: block;
+}
+
+ul.sidebar-menu li ul.sub li{
+    background: #eeeeee;
+    margin-bottom: 0;
+    margin-left: 0;
+    margin-right: 0;
+}
+
+ul.sidebar-menu li ul.sub li:last-child{
+    border-radius: 0 0 4px 4px;
+    -webkit-border-radius: 0 0 4px 4px;
+}
+
+ul.sidebar-menu li ul.sub li a {
+    font-size: 12px;
+    padding: 0 0 0 32px;
+    line-height: 35px;
+    height: 35px;
+    -webkit-transition: all 0.3s ease;
+    -moz-transition: all 0.3s ease;
+    -o-transition: all 0.3s ease;
+    -ms-transition: all 0.3s ease;
+    transition: all 0.3s ease;
+    color: #656C73;
+    font-size: 14px;
+}
+
+ul.sidebar-menu li ul.sub li a:hover, ul.sidebar-menu li ul.sub li.active a {
+    color: #ff4088;
+    -webkit-transition: all 0.3s ease;
+    -moz-transition: all 0.3s ease;
+    -o-transition: all 0.3s ease;
+    -ms-transition: all 0.3s ease;
+    transition: all 0.3s ease;
+    display: block;
+}
+
+ul.sidebar-menu li{
+    line-height: 20px !important;
+}
+
+ul.sidebar-menu li.sub-menu{
+    line-height: 15px;
+    font-size: 16px;
+}
+
+ul.sidebar-menu li a span{
+    display: inline-block;
+}
+
+ul.sidebar-menu li a{
+    color: #72767D;
+    text-decoration: none;
+    display: block;
+    padding: 10px 0 10px 10px;
+    font-size: 16px;
+    font-weight: 400;
+    outline: none;
+    -webkit-transition: all 0.3s ease;
+    -moz-transition: all 0.3s ease;
+    -o-transition: all 0.3s ease;
+    -ms-transition: all 0.3s ease;
+    transition: all 0.3s ease;
+    border-right: 1px solid #D7D7D7;
+    border-bottom: 1px solid #D7D7D7;
+    white-space: nowrap;
+}
+
+ul.sidebar-menu li.active a, ul.sidebar-menu li a:hover, ul.sidebar-menu li a:focus {
+    background: #eeeeee;
+    color: #ff4088;
+    display: block;
+    /*border-radius: 4px;
+    -webkit-border-radius: 4px;*/
+    -webkit-transition: all 0.3s ease;
+    -moz-transition: all 0.3s ease;
+    -o-transition: all 0.3s ease;
+    -ms-transition: all 0.3s ease;
+    transition: all 0.3s ease;
+}
+ul.sidebar-menu li a:hover, ul.sidebar-menu li a:focus {
+    border-bottom: 1px solid #ff4088;
+}
+/*ul.sidebar-menu li.active a,*/ ul.sidebar-menu .sub-menu li.active a{
+    border-bottom: 1px solid #ff4088;
+}
+
+ul.sidebar-menu li a i {
+    font-size: 18px;
+    padding-right: 6px;
+    /*color: #ff4088;*/
+}
+
+ul.sidebar-menu li a:hover i, ul.sidebar-menu li a:focus i {
+    color: #ff4088;
+}
+
+ul.sidebar-menu li.active a i {
+    color: #ff4088;
+}
+
+
+#sidebar ul > li > a .menu-arrow {
+    float: right;
+    margin-right: 8px;
+    margin-top: 6px;
+}
+
+@-moz-document url-prefix() {
+  #sidebar ul > li > a .menu-arrow {
+      float: right;
+      margin-right: 8px;
+      margin-top: -16px;
+  }
+}
+
+#main-content {
+    margin-left: 200px;
+    line-height: 1.8;
+    font-size: 18px;
+}
+
+.header {
+    min-height: 60px;
+    padding: 0 10px;
+}
+.header {
+    position: fixed;
+    left: 0;
+    right: 0;
+    z-index: 1002;
+    text-align:center;
+}
+
+
+.black-bg {
+    background: rgba(20,20,20,0.9);
+    border-bottom: 1px solid #f1f2f7;
+}
+
+.wrapper {
+    display: inline-block;
+    margin-top: 60px;
+    padding: 0px 15px 15px 0px;
+    width: 100%;
+}
+
+a.logo {
+    font-size: 22px;
+    font-weight: 400;
+    color: #8E8E93;
+    float: left;
+    margin-top: 10px;
+    text-transform: uppercase;
+}
+
+a.logo:hover, a.logo:focus {
+    text-decoration: none;
+    outline: none;
+}
+
+h1.top-menu {
+    margin-top: -5px;
+}
+.title-row {
+    margin-top: 15px;
+    margin-left: 16px;
+    color: #EEE;
+}
+.notification-row {
+    float: right;
+    margin-top: 15px;
+    margin-left: 65px;
+}
+
+
+.top-nav  {
+    margin-top: 15px;
+}
+
+/*--sidebar toggle---*/
+
+.toggle-nav {
+    float: left;
+    padding-right: 5px;
+    margin-top: 20px;
+    cursor: pointer;
+    color: gray;
+}
+
+.toggle-nav .icon-reorder {
+    cursor: pointer;
+    display: inline-block;
+    font-size: 20px;
+}
+
+
+@-webkit-keyframes square {
+  0% { background-position: 0 0; }
+  25% { background-position: 100% 0; }
+  50% { background-position: 100% 100%; }
+  75% { background-position: 0 100%; }
+  100% { background-position: 0 0; }
+}
+
+@-ms-keyframes square {
+  0% { background-position: 0 0; }
+  25% { background-position: 100% 0; }
+  50% { background-position: 100% 100%; }
+  75% { background-position: 0 100%; }
+  100% { background-position: 0 0; }
+}
+
+@keyframes square {
+  0% { background-position: 0 0; }
+  25% { background-position: 100% 0; }
+  50% { background-position: 100% 100%; }
+  75% { background-position: 0 100%; }
+  100% { background-position: 0 0; }
+}
+
+.navigation {
+    position: absolute;
+    top: 0;
+    bottom: 0;
+    margin: 0;
+    max-width: 150px;
+    min-width: 90px;
+    width:100%;
+    min-height:1200px;
+    cursor:pointer;
+    display: flex;
+    justify-content: center;
+    align-content: center;
+    flex-direction: column;
+    font-size: 6em;
+    color: rgba(0,0,0,0.5);
+    text-align: center;
+    -webkit-transition: all 350ms ease;
+    transition: all 350ms ease;
+}
+
+.navigation.next {
+    right:0;
+}
+
+
+.navigation:hover {
+    background-color: rgba(0,0,0,0.1);
+}
+
+/* Google Custom Search box */
+
+input.gsc-input,
+.gsc-input-box,
+.gsc-input-box-hover,
+.gsc-input-box-focus,
+.gsc-search-button,
+.gsc-inline-block {
+  box-sizing: content-box;
+  line-height: normal;
+}
+
+.gsc-control-cse {
+  padding: 0.1em 0 0.5em 1em !important;
+  width: 16em !important;
+  float: right;
+}
+
+input.gsc-search-button-v2 {
+  padding: 6px 12px !important;
+}
+
+.gsc-search-box-tools .gsc-search-box .gsc-input {
+  padding-right: 1px !important;
+}
+
+/* Styled keypress from Wikipedia */
+
+kbd {
+  border: 1px solid #aaa;
+  -moz-border-radius: 0.2em;
+  -webkit-border-radius: 0.2em;
+  border-radius: 0.2em;
+  -moz-box-shadow: 0.1em 0.2em 0.2em #ddd;
+  -webkit-box-shadow: 0.1em 0.2em 0.2em #ddd;
+