Add a showcase chapter "Made with Arche" to the documentation page (#411

)

CHANGELOG.md

@@ -4,6 +4,10 @@
 
 * Adds `Entity.ID()` and `Entity.Generation()` (#408, [delaneyj](https://github.com/delaneyj))
 
+### Documentation
+
+* Adds a showcase chapter "Made with Arche" to the documentation page (#411)
+
 ### First-time contributors
 
 * [delaneyj](https://github.com/delaneyj)

docs/content/made_with/_index.md

@@ -0,0 +1,26 @@
++++
+title = "Made with Arche"
+weight = 4
+description = "Projects using Arche."
++++
+
+If you made something using Arche and would like to see it here, feel free to open an [issue](https://github.com/mlange-42/arche/issues) or start a [discussion](https://github.com/mlange-42/arche/discussions)
+in the {{< repo "" "GitHub repository" >}}.
+
+{{< row >}}
+
+{{< card 
+    title="Tiny World"
+    image=https://github.com/mlange-42/arche/assets/44003176/c89487dd-30b6-4384-b8dd-00b09af6e017
+    link=https://mlange-42.itch.io/tiny-world >}}
+A tiny, slow-paced world and colony building game.
+{{< /card >}}
+
+{{< card 
+    title="Arche Demo"
+    image=https://github.com/mlange-42/arche/assets/44003176/ba5427fc-0fdc-4442-8de5-33dae63ea71f
+    link=https://mlange-42.github.io/arche-demo/ >}}
+Demo models and visualizations for Arche.
+{{< /card >}}
+
+{{< /row >}}

docs/hugo.toml

@@ -46,12 +46,6 @@ identifier = "api"
 url = "https://pkg.go.dev/github.com/mlange-42/arche"
 weight = 20
 
-[[menu.shortcuts]]
-name = "<i class='fas fa-fw fa-eye'></i> Web demo"
-identifier = "demo"
-url = "https://mlange-42.github.io/arche-demo/"
-weight = 30
-
 [markup]
   [markup.highlight]
     lineNumbersInTable = false

docs/layouts/partials/custom-header.html

@@ -1 +1,2 @@
-<link href="{{"css/style.css" | relURL}}" rel="stylesheet">
+<link href="{{"css/style.css" | relURL}}" rel="stylesheet">
+<link href="{{"css/cards.css" | relURL}}" rel="stylesheet">

docs/layouts/shortcodes/card.html

@@ -0,0 +1,18 @@
+<div class="column">
+<div class="card">
+{{- $image := .Get "image" -}}
+{{- $link := .Get "link" -}}
+{{- $title := .Get "title" -}}
+<a href="{{ $link }}" target="_blank">
+{{- if $image -}}
+    <img src="{{ $image }}" />
+{{- end -}}
+{{- if $title -}}
+    <b>{{ $title }}</b>
+{{- end -}}
+</a>
+<div class="small">
+{{.Inner | markdownify}}
+</div>
+</div>
+</div>

docs/layouts/shortcodes/row.html

@@ -0,0 +1,3 @@
+<div class="row">
+{{.Inner}}
+</div>

docs/static/css/cards.css

@@ -0,0 +1,39 @@
+
+/* Float four columns side by side */
+.column {
+    float: left;
+    width: 33%;
+    padding: 0 10px 20px 10px;
+}
+
+/* Remove extra left and right margins, due to padding in columns */
+.row {margin: 0 -5px;}
+
+/* Clear floats after the columns */
+.row:after {
+    content: "";
+    display: table;
+    clear: both;
+}
+
+/* Style the counter cards */
+.card {
+    box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.3); /* this adds the "card" effect */
+    padding: 16px;
+    text-align: center;
+    background-color: rgba( 134, 134, 134, .066 );
+}
+
+/* Responsive columns - one column layout (vertical) on small screens */
+@media screen and (max-width: 800px) {
+    .column {
+        width: 50%;
+    }
+}
+
+/* Responsive columns - one column layout (vertical) on small screens */
+@media screen and (max-width: 500px) {
+    .column {
+      width: 100%;
+    }
+}

docs/static/css/style.css

@@ -3,6 +3,10 @@ body {
     tab-size: 2em;
 }
 
+.small {
+    font-size: 1.1rem;
+}
+
 pre:not(.mermaid) code {
     font-size: 0.96rem;
 }