shithub: hugo

Download patch

ref: 486bc46a5217a9d70fe0d14ab9261d7b4eb026d6
parent: 61f210dd7abe5de77c27dc6a6995a3ad5e77afa1
author: Bjørn Erik Pedersen <[email protected]>
date: Fri Nov 2 08:56:19 EDT 2018

docs: Regenerate the docs helper

--- a/docs/data/docs.json
+++ b/docs/data/docs.json
@@ -82,6 +82,13 @@
         ]
       },
       {
+        "Name": "Ballerina",
+        "Aliases": [
+          "bal",
+          "ballerina"
+        ]
+      },
+      {
         "Name": "Base Makefile",
         "Aliases": [
           "*",
@@ -209,6 +216,13 @@
         ]
       },
       {
+        "Name": "Cassandra CQL",
+        "Aliases": [
+          "cassandra",
+          "cql"
+        ]
+      },
+      {
         "Name": "Ceylon",
         "Aliases": [
           "ceylon"
@@ -525,6 +539,7 @@
         "Aliases": [
           "cfg",
           "dosini",
+          "gitconfig",
           "inf",
           "ini"
         ]
@@ -577,6 +592,12 @@
         ]
       },
       {
+        "Name": "Jungle",
+        "Aliases": [
+          "jungle"
+        ]
+      },
+      {
         "Name": "Kotlin",
         "Aliases": [
           "kotlin",
@@ -652,6 +673,13 @@
         ]
       },
       {
+        "Name": "MonkeyC",
+        "Aliases": [
+          "mc",
+          "monkeyc"
+        ]
+      },
+      {
         "Name": "MorrowindScript",
         "Aliases": [
           "morrowind",
@@ -737,6 +765,20 @@
         ]
       },
       {
+        "Name": "OpenSCAD",
+        "Aliases": [
+          "openscad",
+          "scad"
+        ]
+      },
+      {
+        "Name": "Org Mode",
+        "Aliases": [
+          "org",
+          "orgmode"
+        ]
+      },
+      {
         "Name": "PHP",
         "Aliases": [
           "inc",
@@ -941,6 +983,13 @@
         ]
       },
       {
+        "Name": "SYSTEMD",
+        "Aliases": [
+          "service",
+          "systemd"
+        ]
+      },
+      {
         "Name": "Sass",
         "Aliases": [
           "sass"
@@ -1077,6 +1126,13 @@
         ]
       },
       {
+        "Name": "TradingView",
+        "Aliases": [
+          "tradingview",
+          "tv"
+        ]
+      },
+      {
         "Name": "Transact-SQL",
         "Aliases": [
           "t-sql",
@@ -1232,75 +1288,131 @@
     "types": [
       {
         "type": "application/javascript",
-        "string": "application/javascript+js",
+        "string": "application/javascript",
         "mainType": "application",
         "subType": "javascript",
-        "suffix": "js",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "js"
+        ]
       },
       {
         "type": "application/json",
-        "string": "application/json+json",
+        "string": "application/json",
         "mainType": "application",
         "subType": "json",
-        "suffix": "json",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "json"
+        ]
       },
       {
-        "type": "application/rss",
+        "type": "application/octet-stream",
+        "string": "application/octet-stream",
+        "mainType": "application",
+        "subType": "octet-stream",
+        "delimiter": "",
+        "suffixes": null
+      },
+      {
+        "type": "application/rss+xml",
         "string": "application/rss+xml",
         "mainType": "application",
         "subType": "rss",
-        "suffix": "xml",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "xml"
+        ]
       },
       {
         "type": "application/xml",
-        "string": "application/xml+xml",
+        "string": "application/xml",
         "mainType": "application",
         "subType": "xml",
-        "suffix": "xml",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "xml"
+        ]
       },
       {
+        "type": "image/svg+xml",
+        "string": "image/svg+xml",
+        "mainType": "image",
+        "subType": "svg",
+        "delimiter": ".",
+        "suffixes": [
+          "svg"
+        ]
+      },
+      {
         "type": "text/calendar",
-        "string": "text/calendar+ics",
+        "string": "text/calendar",
         "mainType": "text",
         "subType": "calendar",
-        "suffix": "ics",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "ics"
+        ]
       },
       {
         "type": "text/css",
-        "string": "text/css+css",
+        "string": "text/css",
         "mainType": "text",
         "subType": "css",
-        "suffix": "css",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "css"
+        ]
       },
       {
         "type": "text/csv",
-        "string": "text/csv+csv",
+        "string": "text/csv",
         "mainType": "text",
         "subType": "csv",
-        "suffix": "csv",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "csv"
+        ]
       },
       {
         "type": "text/html",
-        "string": "text/html+html",
+        "string": "text/html",
         "mainType": "text",
         "subType": "html",
-        "suffix": "html",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "html"
+        ]
       },
       {
         "type": "text/plain",
-        "string": "text/plain+txt",
+        "string": "text/plain",
         "mainType": "text",
         "subType": "plain",
-        "suffix": "txt",
-        "delimiter": "."
+        "delimiter": ".",
+        "suffixes": [
+          "txt"
+        ]
+      },
+      {
+        "type": "text/x-sass",
+        "string": "text/x-sass",
+        "mainType": "text",
+        "subType": "x-sass",
+        "delimiter": ".",
+        "suffixes": [
+          "sass"
+        ]
+      },
+      {
+        "type": "text/x-scss",
+        "string": "text/x-scss",
+        "mainType": "text",
+        "subType": "x-scss",
+        "delimiter": ".",
+        "suffixes": [
+          "scss"
+        ]
       }
     ]
   },
@@ -1307,15 +1419,17 @@
   "output": {
     "formats": [
       {
-        "MediaType": "text/html+html",
+        "MediaType": "text/html",
         "name": "AMP",
         "mediaType": {
           "type": "text/html",
-          "string": "text/html+html",
+          "string": "text/html",
           "mainType": "text",
           "subType": "html",
-          "suffix": "html",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "html"
+          ]
         },
         "path": "amp",
         "baseName": "index",
@@ -1327,15 +1441,17 @@
         "notAlternative": false
       },
       {
-        "MediaType": "text/css+css",
+        "MediaType": "text/css",
         "name": "CSS",
         "mediaType": {
           "type": "text/css",
-          "string": "text/css+css",
+          "string": "text/css",
           "mainType": "text",
           "subType": "css",
-          "suffix": "css",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "css"
+          ]
         },
         "path": "",
         "baseName": "styles",
@@ -1347,15 +1463,17 @@
         "notAlternative": true
       },
       {
-        "MediaType": "text/csv+csv",
+        "MediaType": "text/csv",
         "name": "CSV",
         "mediaType": {
           "type": "text/csv",
-          "string": "text/csv+csv",
+          "string": "text/csv",
           "mainType": "text",
           "subType": "csv",
-          "suffix": "csv",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "csv"
+          ]
         },
         "path": "",
         "baseName": "index",
@@ -1367,15 +1485,17 @@
         "notAlternative": false
       },
       {
-        "MediaType": "text/calendar+ics",
+        "MediaType": "text/calendar",
         "name": "Calendar",
         "mediaType": {
           "type": "text/calendar",
-          "string": "text/calendar+ics",
+          "string": "text/calendar",
           "mainType": "text",
           "subType": "calendar",
-          "suffix": "ics",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "ics"
+          ]
         },
         "path": "",
         "baseName": "index",
@@ -1387,15 +1507,17 @@
         "notAlternative": false
       },
       {
-        "MediaType": "text/html+html",
+        "MediaType": "text/html",
         "name": "HTML",
         "mediaType": {
           "type": "text/html",
-          "string": "text/html+html",
+          "string": "text/html",
           "mainType": "text",
           "subType": "html",
-          "suffix": "html",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "html"
+          ]
         },
         "path": "",
         "baseName": "index",
@@ -1407,15 +1529,17 @@
         "notAlternative": false
       },
       {
-        "MediaType": "application/json+json",
+        "MediaType": "application/json",
         "name": "JSON",
         "mediaType": {
           "type": "application/json",
-          "string": "application/json+json",
+          "string": "application/json",
           "mainType": "application",
           "subType": "json",
-          "suffix": "json",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "json"
+          ]
         },
         "path": "",
         "baseName": "index",
@@ -1427,15 +1551,17 @@
         "notAlternative": false
       },
       {
-        "MediaType": "text/plain+txt",
+        "MediaType": "text/plain",
         "name": "ROBOTS",
         "mediaType": {
           "type": "text/plain",
-          "string": "text/plain+txt",
+          "string": "text/plain",
           "mainType": "text",
           "subType": "plain",
-          "suffix": "txt",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "txt"
+          ]
         },
         "path": "",
         "baseName": "robots",
@@ -1450,12 +1576,14 @@
         "MediaType": "application/rss+xml",
         "name": "RSS",
         "mediaType": {
-          "type": "application/rss",
+          "type": "application/rss+xml",
           "string": "application/rss+xml",
           "mainType": "application",
           "subType": "rss",
-          "suffix": "xml",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "xml"
+          ]
         },
         "path": "",
         "baseName": "index",
@@ -1467,15 +1595,17 @@
         "notAlternative": false
       },
       {
-        "MediaType": "application/xml+xml",
+        "MediaType": "application/xml",
         "name": "Sitemap",
         "mediaType": {
           "type": "application/xml",
-          "string": "application/xml+xml",
+          "string": "application/xml",
           "mainType": "application",
           "subType": "xml",
-          "suffix": "xml",
-          "delimiter": "."
+          "delimiter": ".",
+          "suffixes": [
+            "xml"
+          ]
         },
         "path": "",
         "baseName": "sitemap",
@@ -2119,6 +2249,16 @@
           ],
           "Examples": []
         },
+        "Append": {
+          "Description": "Append appends the arguments up to the last one to the slice in the last argument.\nThis construct allows template constructs like this:\n    {{ $pages = $pages | append $p2 $p1 }}\nNote that with 2 arguments where both are slices of the same type,\nthe first slice will be appended to the second:\n    {{ $pages = $pages | append .Site.RegularPages }}",
+          "Args": [
+            "args"
+          ],
+          "Aliases": [
+            "append"
+          ],
+          "Examples": []
+        },
         "Apply": {
           "Description": "Apply takes a map, array, or slice and returns a new slice with the function fname applied over it.",
           "Args": [
@@ -2185,6 +2325,17 @@
           ],
           "Examples": []
         },
+        "Group": {
+          "Description": "Group groups a set of elements by the given key.\nThis is currently only supported for Pages.",
+          "Args": [
+            "key",
+            "items"
+          ],
+          "Aliases": [
+            "group"
+          ],
+          "Examples": []
+        },
         "In": {
           "Description": "In returns whether v is in the set l.  l may be an array or slice.",
           "Args": [
@@ -2262,6 +2413,19 @@
           ],
           "Examples": []
         },
+        "NewScratch": {
+          "Description": "NewScratch creates a new Scratch which can be used to store values in a\nthread safe way.",
+          "Args": null,
+          "Aliases": [
+            "newScratch"
+          ],
+          "Examples": [
+            [
+              "{{ $scratch := newScratch }}{{ $scratch.Add \"b\" 2 }}{{ $scratch.Add \"b\" 2 }}{{ $scratch.Get \"b\" }}",
+              "4"
+            ]
+          ]
+        },
         "Querify": {
           "Description": "Querify encodes the given parameters in URL-encoded form (\"bar=baz\u0026foo=quux\") sorted by key.",
           "Args": [
@@ -2486,7 +2650,7 @@
           ]
         },
         "Jsonify": {
-          "Description": "Jsonify encodes a given object to JSON.",
+          "Description": "Jsonify encodes a given object to JSON, returning pretty printed output.",
           "Args": [
             "v"
           ],
@@ -2496,7 +2660,7 @@
           "Examples": [
             [
               "{{ (slice \"A\" \"B\" \"C\") | jsonify }}",
-              "[\"A\",\"B\",\"C\"]"
+              "[\n  \"A\",\n  \"B\",\n  \"C\"\n]"
             ]
           ]
         }
@@ -2503,7 +2667,7 @@
       },
       "fmt": {
         "Errorf": {
-          "Description": "",
+          "Description": "Errorf formats according to a format specifier and returns the string as a\nvalue that satisfies error.",
           "Args": [
             "format",
             "a"
@@ -2675,7 +2839,7 @@
           ]
         },
         "Translate": {
-          "Description": "Translate ...",
+          "Description": "Translate returns a translated string for id.",
           "Args": [
             "id",
             "args"
@@ -2838,19 +3002,6 @@
         }
       },
       "os": {
-        "Stat": {
-          "Description": "Stat returns a file infomation under the given path.",
-          "Args": [
-            "i"
-          ],
-          "Aliases": null,
-          "Examples": [
-            [
-              "{{ (os.Stat \"foo.txt\").Name }}",
-              "foo.txt"
-            ]
-          ]
-        },
         "FileExists": {
           "Description": "FileExists checks whether a file exists under the given path.",
           "Args": [
@@ -2886,7 +3037,7 @@
           ],
           "Examples": [
             [
-              "{{ range (readDir \".\") }}{{ .Name }}{{ end }}",
+              "{{ range (readDir \"files\") }}{{ .Name }}{{ end }}",
               "README.txt"
             ]
           ]
@@ -2901,10 +3052,16 @@
           ],
           "Examples": [
             [
-              "{{ readFile \"README.txt\" }}",
+              "{{ readFile \"files/README.txt\" }}",
               "Hugo Rocks!"
             ]
           ]
+        },
+        "Stat": {
+          "Description": "",
+          "Args": null,
+          "Aliases": null,
+          "Examples": null
         }
       },
       "partials": {
@@ -3003,6 +3160,74 @@
           ]
         }
       },
+      "resources": {
+        "Concat": {
+          "Description": "",
+          "Args": null,
+          "Aliases": null,
+          "Examples": null
+        },
+        "ExecuteAsTemplate": {
+          "Description": "",
+          "Args": null,
+          "Aliases": null,
+          "Examples": null
+        },
+        "Fingerprint": {
+          "Description": "Fingerprint transforms the given Resource with a MD5 hash of the content in\nthe RelPermalink and Permalink.",
+          "Args": [
+            "args"
+          ],
+          "Aliases": [
+            "fingerprint"
+          ],
+          "Examples": []
+        },
+        "FromString": {
+          "Description": "",
+          "Args": null,
+          "Aliases": null,
+          "Examples": null
+        },
+        "Get": {
+          "Description": "Get locates the filename given in Hugo's filesystems: static, assets and content (in that order)\nand creates a Resource object that can be used for further transformations.",
+          "Args": [
+            "filename"
+          ],
+          "Aliases": null,
+          "Examples": []
+        },
+        "Minify": {
+          "Description": "Minify minifies the given Resource using the MediaType to pick the correct\nminifier.",
+          "Args": [
+            "r"
+          ],
+          "Aliases": [
+            "minify"
+          ],
+          "Examples": []
+        },
+        "PostCSS": {
+          "Description": "PostCSS processes the given Resource with PostCSS",
+          "Args": [
+            "args"
+          ],
+          "Aliases": [
+            "postCSS"
+          ],
+          "Examples": []
+        },
+        "ToCSS": {
+          "Description": "ToCSS converts the given Resource to CSS. You can optional provide an Options\nobject or a target path (string) as first argument.",
+          "Args": [
+            "args"
+          ],
+          "Aliases": [
+            "toCSS"
+          ],
+          "Examples": []
+        }
+      },
       "safe": {
         "CSS": {
           "Description": "CSS returns a given string as html/template CSS content.",
@@ -3165,6 +3390,19 @@
             ]
           ]
         },
+        "FirstUpper": {
+          "Description": "FirstUpper returns a string with the first character as upper case.",
+          "Args": [
+            "s"
+          ],
+          "Aliases": null,
+          "Examples": [
+            [
+              "{{ \"hugo rocks!\" | strings.FirstUpper }}",
+              "Hugo rocks!"
+            ]
+          ]
+        },
         "HasPrefix": {
           "Description": "HasPrefix tests whether the input s begins with prefix.",
           "Args": [
@@ -3443,6 +3681,25 @@
           ]
         }
       },
+      "templates": {
+        "Exists": {
+          "Description": "Exists returns whether the template with the given name exists.\nNote that this is the Unix-styled relative path including filename suffix,\ne.g. partials/header.html",
+          "Args": [
+            "name"
+          ],
+          "Aliases": null,
+          "Examples": [
+            [
+              "{{ if (templates.Exists \"partials/header.html\") }}Yes!{{ end }}",
+              "Yes!"
+            ],
+            [
+              "{{ if not (templates.Exists \"partials/doesnotexist.html\") }}No!{{ end }}",
+              "No!"
+            ]
+          ]
+        }
+      },
       "time": {
         "AsTime": {
           "Description": "AsTime converts the textual representation of the datetime string into\na time.Time interface.",
@@ -3680,7 +3937,7 @@
           "Description": "Ref returns the absolute URL path to a given content item.",
           "Args": [
             "in",
-            "refs"
+            "args"
           ],
           "Aliases": [
             "ref"
@@ -3701,7 +3958,7 @@
           "Description": "RelRef returns the relative URL path to a given content item.",
           "Args": [
             "in",
-            "refs"
+            "args"
           ],
           "Aliases": [
             "relref"