📝 Visual updates to documentation

exampleSite/content/_index.md

@@ -24,6 +24,6 @@ This is a demo site built entirely using Congo. It also contains a complete set
   </span>
 </div>
 
-Explore the [sample pages]({{< ref "samples" >}}) to get a feel for what Congo can do. If you like what you see, check out the project on [Github](https://github.com/jpanther/congo) or read the [Installation guide]({{< ref "docs/installation" >}}) to get started.
+{{< figure src="festivities.svg" class="m-auto mt-6 max-w-prose" >}}
 
-![A stylised photograph of a purple squid on a pink backdrop.](squid.jpg "Photo by [Jippe Joosten](https://unsplash.com/@jippe_joosten?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText) on [Unsplash](https://unsplash.com/s/photos/vibrant-purple?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText).")
+Explore the [sample pages]({{< ref "samples" >}}) to get a feel for what Congo can do. If you like what you see, check out the project on [Github](https://github.com/jpanther/congo) or read the [Installation guide]({{< ref "docs/installation" >}}) to get started.

exampleSite/content/docs/_index.md

@@ -5,6 +5,7 @@ description: "Learn how to use Congo and its features."
 cascade:
   showDate: false
   showAuthor: false
+  showSummary: true
   invertPagination: true
 ---
 
@@ -16,4 +17,6 @@ Simple, yet powerful. Learn how to use Congo and its features.
 
 This section contains everything you need to know about Congo. If you're new, check out the [Installation]({{< ref "docs/installation" >}}) guide to begin or visit the [Samples]({{< ref "samples" >}}) section to see what Congo can do.
 
+_Special thanks to [Katerina Limpitsouni](https://ninalimpi.com) for the excellent illustrations that are used throughout these docs!_
+
 ---

exampleSite/content/docs/advanced-customisation/index.md

@@ -3,6 +3,7 @@ title: "Advanced Customisation"
 date: 2020-08-08
 draft: false
 description: "Learn how to build Congo manually."
+summary: "Congo supports advanced customisations that include modifying the underlying Tailwind configuration, building the theme manually and providing custom CSS."
 slug: "advanced-customisation"
 tags: ["advanced", "css", "docs"]
 ---

exampleSite/content/docs/configuration/index.md

@@ -3,6 +3,7 @@ title: "Configuration"
 date: 2020-08-14
 draft: false
 description: "All the configuration variables available in Congo."
+summary: "Discover all the site, language and theme configurations that are available in Congo and how they can be used to customise your project."
 slug: "configuration"
 tags: ["config", "docs"]
 ---

exampleSite/content/docs/content-examples/index.md

@@ -2,7 +2,8 @@
 title: "Content Examples"
 date: 2020-08-09
 draft: false
-description: "All the partials available in Congo."
+description: "Some examples that demonstrate how content should be created and structured."
+summary: "It's time to bring everything together with some examples that demonstrate how content should be created and structured."
 slug: "content-examples"
 tags: ["content", "example"]
 ---

exampleSite/content/docs/front-matter/index.md

@@ -3,6 +3,7 @@ title: "Front Matter"
 date: 2020-08-12
 draft: false
 description: "All the front matter variables available in Congo."
+summary: "While supporting most Hugo defaults, Congo adds a number of front matter parameters to customise the presentation of individual articles."
 slug: "front-matter"
 tags: ["front matter", "config", "docs"]
 ---

exampleSite/content/docs/getting-started/index.md

@@ -2,7 +2,8 @@
 title: "Getting Started"
 date: 2020-08-15
 draft: false
-description: "All the front matter variables available in Congo."
+description: "Learn how to get started using the Congo theme."
+summary: "This section assumes you have already installed the Congo theme and are ready to start with basic configuration tasks."
 slug: "getting-started"
 tags: ["installation", "docs"]
 ---

exampleSite/content/docs/homepage-layout/index.md

@@ -3,6 +3,7 @@ title: "Homepage Layout"
 date: 2020-08-13
 draft: false
 description: "Configuring the homepage layout in the Congo theme."
+summary: "Congo provides a fully flexible homepage layout with built-in templates and the ability to provide your own."
 slug: "homepage-layout"
 tags: ["homepage", "layouts", "docs"]
 ---

exampleSite/content/docs/hosting-deployment/index.md

@@ -3,6 +3,7 @@ title: "Hosting & Deployment"
 date: 2020-08-07
 draft: false
 description: "Learn how to deploy a Congo site."
+summary: "Congo is designed to be flexible in almost any deployment scenario. Learn more about how to deploy your project to some common hosting platforms."
 slug: "hosting-deployment"
 tags: ["hosting", "deployment", "docs", "github", "netlify", "render"]
 ---
@@ -95,15 +96,15 @@ Then in the root of your site repository, create a `netlify.toml` file:
 
 [build.environment]
   NODE_ENV = "production"
-  GO_VERSION = "1.16"
+  GO_VERSION = "1.19"
   TZ = "UTC"  # Set to preferred timezone
 
 [context.production.environment]
-  HUGO_VERSION = "0.105.0"
+  HUGO_VERSION = "0.109.0"
   HUGO_ENV = "production"
 
 [context.deploy-preview.environment]
-  HUGO_VERSION = "0.105.0"
+  HUGO_VERSION = "0.109.0"
 ```
 
 This configuration assumes you are deploying Congo as a Hugo module. If you have installed the theme using another method, change the build command to simply `hugo --gc --minify -b $URL`.

exampleSite/content/docs/installation/index.md

@@ -3,6 +3,7 @@ title: "Installation"
 date: 2020-08-16
 draft: false
 description: "How to install the Congo theme."
+summary: "Learn how to get up and running using Hugo and Congo from a completely blank state. It's the best place to start if you're a new user."
 slug: "installation"
 tags: ["installation", "docs"]
 ---

exampleSite/content/docs/partials/index.md

@@ -3,6 +3,7 @@ title: "Partials"
 date: 2020-08-10
 draft: false
 description: "All the partials available in Congo."
+summary: "Partials are used to add special functionality to the theme including analytics, comments, favicons, custom scripts and more."
 slug: "partials"
 tags: ["partials", "analytics", "privacy", "comments", "favicons", "icon", "docs"]
 ---

exampleSite/content/docs/shortcodes/index.md

@@ -3,6 +3,7 @@ title: "Shortcodes"
 date: 2020-08-11
 draft: false
 description: "All the shortcodes available in Congo."
+summary: Congo includes several shortcodes for adding rich content to articles including images, charts, diagrams, buttons and more.
 slug: "shortcodes"
 tags: ["shortcodes", "mermaid", "icon", "lead", "docs"]
 ---

exampleSite/content/docs/version-2/_index.md

@@ -3,6 +3,7 @@ title: "What's New in 2.0 ✨"
 date: 2022-01-19
 draft: false
 description: "Discover what's new in Congo version 2.0."
+summary: "Version 2 takes Congo to new heights, making the theme even more powerful while still maintaining its lightweight footprint."
 tags: ["new", "docs"]
 ---
 

exampleSite/content/users/cover-true-love.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" data-name="Layer 1" width="888" height="475.27072" viewBox="0 0 888 475.27072" xmlns:xlink="http://www.w3.org/1999/xlink"><title>true_love</title><rect x="402.54442" y="219.17275" width="2.57298" height="13.89411" transform="translate(-11.71503 -369.44906) rotate(26.64397)" fill="#fff"/><path d="M426.98456,248.842a66.00006,66.00006,0,0,0-93.33814,0l-.01788.01788a65.982,65.982,0,0,0-93.30231,93.30237l-.01788.01788,93.33807,93.33807,93.33814-93.33807A66,66,0,0,0,426.98456,248.842Z" transform="translate(-156 -212.36464)" fill="#ff6584"/><path d="M709.42956,621.81706h-489.679a9.98831,9.98831,0,0,1-1.82989-.145l231.59565-401.157a16.2157,16.2157,0,0,1,28.22705,0L633.17308,489.72253l7.44637,12.8816Z" transform="translate(-156 -212.36464)" fill="#8b5cf6"/><polygon points="553.43 409.452 386.241 409.452 468.314 290.239 474.22 281.652 477.173 277.358 484.619 290.239 553.43 409.452" opacity="0.2"/><path d="M982.07935,621.36464H558.54722l82.07223-119.21293,5.9062-8.58777L753.47313,338.20663c7.01145-10.182,23.87881-10.81607,32.12223-1.92044a19.328,19.328,0,0,1,1.54006,1.92044Z" transform="translate(-156 -212.36464)" fill="#3f3d56"/><rect y="407.93322" width="888" height="2.24072" fill="#3f3d56"/><ellipse cx="570.05705" cy="586.26729" rx="32.34192" ry="10.15313" transform="translate(-329.28848 33.15083) rotate(-21.1763)" fill="#2f2e41"/><circle cx="349.2698" cy="382.74826" r="64.68385" fill="#2f2e41"/><rect x="319.79361" y="433.51279" width="19.65079" height="35.20766" fill="#2f2e41"/><rect x="359.09519" y="433.51279" width="19.65079" height="35.20766" fill="#2f2e41"/><ellipse cx="336.16927" cy="469.12985" rx="16.37566" ry="6.14087" fill="#2f2e41"/><ellipse cx="375.47085" cy="468.31107" rx="16.37566" ry="6.14087" fill="#2f2e41"/><circle cx="350.90736" cy="366.3726" r="22.10714" fill="#fff"/><circle cx="350.90736" cy="366.3726" r="7.36905" fill="#3f3d56"/><path d="M442.52428,534.95878c-5.22292-23.39065,11.47266-47.02591,37.29064-52.79083s50.9816,8.52354,56.20452,31.91418-11.88759,32.01752-37.70556,37.78245S447.74721,558.34942,442.52428,534.95878Z" transform="translate(-156 -212.36464)" fill="#e6e6e6"/><ellipse cx="440.41422" cy="603.0993" rx="32.34192" ry="10.15313" transform="translate(-453.46127 275.69894) rotate(-45)" fill="#2f2e41"/><path d="M473.49729,618.44821c0,6.33082,16.30083,18.832,34.38888,18.832s35.04764-17.82327,35.04764-24.15409-16.95958,1.22817-35.04764,1.22817S473.49729,612.11739,473.49729,618.44821Z" transform="translate(-156 -212.36464)" fill="#fff"/><ellipse cx="623.94295" cy="586.26729" rx="10.15313" ry="32.34192" transform="translate(-304.12811 743.93025) rotate(-68.8237)" fill="#2f2e41"/><circle cx="532.7302" cy="382.74826" r="64.68385" fill="#2f2e41"/><rect x="698.5556" y="645.87743" width="19.65079" height="35.20766" transform="translate(1260.76198 1114.59789) rotate(-180)" fill="#2f2e41"/><rect x="659.25402" y="645.87743" width="19.65079" height="35.20766" transform="translate(1182.15883 1114.59789) rotate(-180)" fill="#2f2e41"/><ellipse cx="545.83073" cy="469.12985" rx="16.37566" ry="6.14087" fill="#2f2e41"/><ellipse cx="506.52915" cy="468.31107" rx="16.37566" ry="6.14087" fill="#2f2e41"/><circle cx="531.09264" cy="366.3726" r="22.10714" fill="#fff"/><circle cx="531.09264" cy="366.3726" r="7.36905" fill="#3f3d56"/><path d="M751.47572,534.95878c5.22292-23.39065-11.47266-47.02591-37.29064-52.79083s-50.9816,8.52354-56.20452,31.91418,11.88759,32.01752,37.70556,37.78245S746.25279,558.34942,751.47572,534.95878Z" transform="translate(-156 -212.36464)" fill="#8b5cf6"/><ellipse cx="753.58578" cy="603.0993" rx="10.15313" ry="32.34192" transform="translate(-361.73544 497.14467) rotate(-45)" fill="#2f2e41"/><path d="M720.50271,618.44821c0,6.33082-16.30083,18.832-34.38888,18.832s-35.04764-17.82327-35.04764-24.15409,16.95958,1.22817,35.04764,1.22817S720.50271,612.11739,720.50271,618.44821Z" transform="translate(-156 -212.36464)" fill="#fff"/><path d="M1044,527.22724c0,41.80115-24.85012,56.39655-55.5043,56.39655s-55.5043-14.5954-55.5043-56.39655,55.5043-94.97881,55.5043-94.97881S1044,485.42608,1044,527.22724Z" transform="translate(-156 -212.36464)" fill="#e6e6e6"/><polygon points="830.474 364.865 831.042 329.881 854.699 286.601 831.131 324.393 831.387 308.663 847.691 277.35 831.454 304.5 831.454 304.5 831.914 276.209 849.373 251.28 831.986 271.76 832.273 219.884 830.469 288.559 830.617 285.726 812.866 258.555 830.332 291.164 828.678 322.761 828.629 321.922 808.166 293.329 828.567 324.885 828.36 328.836 828.323 328.896 828.34 329.22 824.144 409.383 829.751 409.383 830.423 367.977 850.775 336.499 830.474 364.865" fill="#3f3d56"/></svg>

exampleSite/content/users/index.md

@@ -12,9 +12,11 @@ showEdit: false
 ---
 
 {{< lead >}}
-Real websites that are built with Congo.
+Real websites that have been built using Congo.
 {{< /lead >}}
 
+The list below is just a handful of the websites that are built using the Congo theme. Check them out to discover some great exampels of what the theme can do.
+
 | Website                                                                | Details                       |
 | ---------------------------------------------------------------------- | ----------------------------- |
 | [jamespanther.com](https://jamespanther.com)                           | Personal site - Theme author  |

exampleSite/layouts/shortcodes/swatches.html

@@ -1,14 +1,14 @@
 <div class="flex justify-between">
   <span
-    class="w-full py-6 mr-3 rounded-md"
+    class="w-full py-6 mr-2 rounded-md"
     {{ with .Get 0 }}style="background-color: {{ . }}"{{ end }}
   ></span>
   <span
-    class="w-full py-6 mr-3 rounded-md"
+    class="w-full py-6 mr-2 rounded-md"
     {{ with .Get 1 }}style="background-color: {{ . }}"{{ end }}
   ></span>
   <span
-    class="w-full py-6 mr-3 rounded-md"
+    class="w-full py-6 mr-2 rounded-md"
     {{ with .Get 2 }}style="background-color: {{ . }}"{{ end }}
   ></span>
 </div>