Upgrade to latest Hugo

.github/workflows/build-and-deploy.yml

@@ -26,7 +26,7 @@ jobs:
 
       - uses: peaceiris/actions-hugo@v2
         with:
-          hugo-version: '0.55.4'
+          hugo-version: '0.81.0'
           extended: true
 
       - name: Install assume-role

README.md

@@ -36,16 +36,8 @@ The following commands use the package manager, [Homebrew](https://brew.sh/).
 
 ##### Install Hugo
 
-If you already have Hugo installed, uninstall it:
-
-```bash
-brew uninstall hugo
-```
-
-Install Hugo v0.55.4:
-
 ```bash
-brew install pulumi/tap/hugo@0.55.4
+brew install hugo
 ```
 
 ##### Install Go

components/README.md

@@ -167,15 +167,25 @@ Similarly:
 
 ```
 {{< chooser cloud "aws,azure,gcp" >}}
+
 {{% choosable cloud aws %}}
+
 Some AWS stuff.
+
 {{% /choosable %}}
+
 {{% choosable cloud azure %}}
+
 Some Azure stuff.
+
 {{% /choosable %}}
+
 {{% choosable cloud gcp %}}
+
 Some GCP stuff.
+
 {{% /choosable %}}
+
 {{< /chooser >}}
 ```
 
@@ -199,8 +209,72 @@ Some GCP stuff.
 
 A few things to note:
 
-* The `choosable` shortcode **renders Markdown automatically**. You don't need use the
-  `md` shortcode to do that anymore. (So please don't, and thank you!)
+* Pay attention to how you nest `chooser` and `choosable` shortcodes. [Hugo shortcodes](https://gohugo.io/content-management/shortcodes/) work with both
+  `<>` and `%%` delimiters, but the two behave very differently: `%` will cause content to be
+  Markdown-rendered, `<` and `>` will not. So for example:
+
+  ```
+  {{< some-shortcode >}}
+
+    This content will *not* be rendered as Markdown.
+
+  {{< /some-shortcode >}}
+
+  {{% some-shortcode %}}
+
+    This content *will* be.
+
+  {{% /some-shortcode %}}
+  ```
+
+  You need to be careful about double-rendering, though. For example, this is okay: the outer
+  container won't be rendered as Markdown, but the inner children will be.
+
+  ```
+  {{< some-parent >}}
+
+    <some-component>
+        Just some regular HTML, here.
+    </some-component>
+
+    {{% some-child %}}
+        [Some Markdown]("http://some-link").
+    {{% /some-child %}}
+
+    {% some-child %}}
+        [Some more Markdown]("http://some-link").
+    {{% /some-child %}}
+
+  {{< /some-parent >}}
+  ```
+
+  If you did this, however:
+
+  ```
+  {{% some-parent %}}
+
+    <some-component>
+        Just some regular HTML, here.
+    </some-component>
+
+    {{% some-child %}}
+        [Some Markdown]("http://some-link").
+    {{% /some-child %}}
+
+    {% some-child %}}
+        [Some more Markdown]("http://some-link").
+    {{% /some-child %}}
+
+  {{% /some-parent %}}
+  ```
+
+  ... the nested shortcodes would be rendered twice -- first by virtue of their being
+  wrapped in a `%`-delimited shortcode, and then a second time when the parent's content
+  is rendered itself. Sometimes this turns out okay, but if you're rendering source code,
+  where indentation matters, you can wind up with some terrible results.
+
+  So as a rule, avoid nesting `%`-delimited shortcodes. Decide which shortcode will be responsible
+  for rendering, and use `%`s on that one, `<>`s on descendants.
 
 * The containing `div`s emitted by the `chooser` and `choosable` shortcodes are
   intentional and in most cases required, because the template renderers we're using today

config/_default/config.toml

@@ -30,7 +30,6 @@ timeout = 300000
 [outputs]
     home = ["HTML"]
     section = ["HTML"]
-    taxonomy = ["HTML"]
 
 [taxonomies]
     author = "authors"
@@ -40,8 +39,25 @@ timeout = 300000
     authors = "/blog/author/:slug/"
     tags = "/blog/tag/:slug/"
 
-[blackfriday]
-    fractions = false
+[markup.goldmark]
+    [markup.goldmark.extensions]
+        definitionList = true
+        footnote = true
+        linkify = true
+        strikethrough = true
+        table = true
+        taskList = true
+        typographer = true
+        [markup.goldmark.parser]
+            autoHeadingID = true
+            autoHeadingIDType = "github"
+    [markup.goldmark.parser.attribute]
+        block = false
+        title = true
+    [markup.goldmark.renderer]
+        hardWraps = false
+        unsafe = true
+        xhtml = false
 
 [params]
     canonicalURL = "https://www.pulumi.com"