Merge pull request #3141 from chef/im/shortcodes

CHEF-4515 reorganize reusable text files in docs

docs-chef-io/Makefile

@@ -5,7 +5,11 @@ SHELL=bash
 preview_netlify: chef_web_docs
 	rm -rf chef-web-docs/_vendor/github.com/chef/supermarket/docs-chef-io/*
 	cp -R content chef-web-docs/_vendor/github.com/chef/supermarket/docs-chef-io/content
-	cp -R layouts chef-web-docs/_vendor/github.com/chef/supermarket/docs-chef-io/layouts
+
+	if [ -d "layouts" ]; then \
+		cp -R layouts chef-web-docs/_vendor/github.com/chef/supermarket/docs-chef-io/layouts; \
+	fi
+
 	cp -R config.toml chef-web-docs/_vendor/github.com/chef/supermarket/docs-chef-io/config.toml
 	pushd chef-web-docs && make bundle; hugo --buildFuture --gc --minify --environment development && popd
 

docs-chef-io/content/supermarket/_index.md

@@ -15,7 +15,7 @@ aliases = ["/supermarket.html"]
     weight = 10
 +++
 
-{{% supermarket/supermarket_summary %}}
+{{< readfile file="content/supermarket/reusable/md/supermarket_summary.md" >}}
 
 ## Public Supermarket
 
@@ -27,4 +27,4 @@ To interact with the public Chef Supermarket, use [knife supermarket](/workstati
 
 ## Private Supermarket
 
-{{% supermarket/supermarket_private %}}
+{{< readfile file="content/supermarket/reusable/md/supermarket_private.md" >}}

docs-chef-io/content/supermarket/reusable/README.md

@@ -0,0 +1,9 @@
+<!-- markdownlint-disable MD002 -->
+# Directory for Reusable Content
+<!-- markdownlint-enable MD002 -->
+
+Files in this directory are used in *more than one place* within the Chef docs.
+
+Store all files in subdirectories organized by file type. For example, all Markdown files should be in `content/<product>/reusable/md/` and all Ruby files are stored in `content/<product>/reusable/rb/`.
+
+Call these files using the [`readfile` shortcode](https://docs.chef.io/style/reuse/#readfile-shortcode).

docs-chef-io/content/supermarket/reusable/index.md

@@ -0,0 +1,5 @@
++++
+headless = true
+## headless = true makes this directory a headless bundle.
+## See https://gohugo.io/content-management/page-bundles/#headless-bundle
++++

docs-chef-io/content/supermarket/supermarket_api.md

@@ -14,10 +14,13 @@ aliases = ["/supermarket_api.html", "/supermarket_api/"]
 <!-- markdownlint-disable-file MD033 MD036-->
 
 {{< note >}}
-In general, using knife (and the `knife supermarket` subcommand) to manage cookbooks that are located on the Cookbooks site is more efficient than using the Supermarket API and is the recommended approach for managing cookbooks on that site. This document provides information about the Supermarket API in the event that using the API is necessary.
+
+In general, using knife (and the `knife supermarket` subcommand) to manage cookbooks that are located on the Cookbooks site is more efficient than using the Supermarket API and is the recommended approach for managing cookbooks on that site.
+This document provides information about the Supermarket API in the event that using the API is necessary.
+
 {{< /note >}}
 
-{{% supermarket/supermarket_api_summary %}}
+{{< readfile file="/content/supermarket/reusable/md/supermarket_api_summary.md" >}}
 
 ## Endpoints
 

docs-chef-io/content/supermarket/supermarket_private.md

@@ -12,8 +12,8 @@ aliases = ["/supermarket.html", "/supermarket_private/"]
     weight = 10
 +++
 
-{{% supermarket/supermarket_summary %}}
+{{< readfile file="content/supermarket/reusable/md/supermarket_summary.md" >}}
 
 ## Private Supermarket
 
-{{% supermarket/supermarket_private %}}
+{{< readfile file="content/supermarket/reusable/md/supermarket_private.md" >}}