Merge pull request #4 from quarto-dev/meta-include

Add example of meta include from blogpost

Author: cwickham

websites/quarto-meta-includes/.gitignore

@@ -0,0 +1,2 @@
+/.quarto/
+_site/

websites/quarto-meta-includes/README.md

@@ -0,0 +1,10 @@
+See live at <https://examples.quarto.pub/quarto-meta-includes/>
+
+## About this example
+
+This example accompanies the blog post at <https://quarto.org/docs/blog/posts/2024-12-20-includes-meta>
+
+It illustrates combining the `meta` and `include` shortcodes.
+
+Original source: <https://github.com/AshleyHenry15/blog-quarto-meta-vars>
+

websites/quarto-meta-includes/_publish.yml

@@ -0,0 +1,4 @@
+- source: project
+  quarto-pub:
+    - id: 5dac494e-2416-4aec-b16e-740cd3391972
+      url: https://examples.quarto.pub/quarto-meta-includes

websites/quarto-meta-includes/_quarto.yml

@@ -0,0 +1,25 @@
+project:
+  type: website
+
+website:
+  title: "`meta` Shortcodes for Precise Includes"
+  repo-url: https://github.com/quarto-dev/quarto-examples
+  repo-subdir: websites/quarto-meta-includes
+  repo-actions: [source]
+  navbar: 
+    left:
+      - href: index.qmd
+        text: "Home"
+      - href: new-york.qmd
+      - href: pa.qmd
+      
+
+
+format:
+  html:
+    theme: yeti
+    css: styles.css
+    toc: true
+
+
+

websites/quarto-meta-includes/_snippets/facts.qmd

@@ -0,0 +1,11 @@
+{{< meta state >}} covers approximately {{< meta square-miles >}} making it the {{< meta size-rank >}} largest state in the United States. As of 2023, {{< meta state >}} has an approximate population of about {{< meta population >}}.
+
+{{< meta state >}}'s official flower is the {{< meta flower >}}, pictured below:
+
+![The official {{< meta state >}} state flower, the {{< meta flower >}}](/images/{{< meta state-abbr >}}/flower.png)
+
+Lastly, {{< meta state >}}'s official animal is the {{< meta animal >}}, pictured below:
+
+![The official {{< meta state >}} state animal, the {{< meta animal >}}](/images/{{< meta state-abbr >}}/animal.png)
+
+

websites/quarto-meta-includes/images/ny/animal.png

@@ -0,0 +1,37 @@
+---
+title: "`meta` Shortcodes for Precise Includes"
+author: Ashley Henry
+---
+
+This is an example site to showcase the use of `meta` shortcodes for more precise includes using Quarto.
+
+It accompanies the blog post at: <https://quarto.org/docs/blog/posts/2024-12-20-includes-meta>
+
+The pages for [New York](new-york.qmd) and [Pennsylvania](pa.qmd) are generated by including the same snippet:
+
+````{.markdown filename="_snippets/facts.qmd" shortcodes="false"}
+{{< meta state >}} covers approximately {{< meta square-miles >}} making it the {{< meta size-rank >}} largest state in the United States. As of 2023, {{< meta state >}} has an approximate population of about {{< meta population >}}.
+
+{{< meta state >}}'s official flower is the {{< meta flower >}}, pictured below:
+
+![The official {{< meta state >}} state flower, the {{< meta flower >}}](/images/{{< meta state-abbr >}}/flower.png)
+
+Lastly, {{< meta state >}}'s official animal is the {{< meta animal >}}, pictured below:
+
+![The official {{< meta state >}} state animal, the {{< meta animal >}}](/images/{{< meta state-abbr >}}/animal.png)
+````
+
+Where the relevant variables are set in each page's metadata, e.g.:
+
+```{.yaml filename="new-york.qmd"}
+---
+title: New York
+state-abbr: ny
+state: New York
+size-rank: 27th
+square-miles: 54,555
+population: 19.8 million
+flower: Rose
+animal: Beaver
+---
+```