docs(blog): add "Logging with OWASP CRS" series

.github/workflows/test.yml

@@ -35,6 +35,9 @@ jobs:
         with:
           submodules: recursive
 
+      - name: Check example archives are up to date
+        run: python3 examples/crs-logging/build-archives.py --check
+
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6

assets/scss/shortcodes/_resources.scss

@@ -0,0 +1,47 @@
+/**/
+/* RESOURCES: list of downloadable page bundle files (layouts/_shortcodes/resources.html) */
+/**/
+
+// `.content div` is full width in the theme; keep the box (a <div> when it
+// is not collapsible) in the text column like everything else.
+.content .resources,
+.resources {
+  max-width: var(--content-width);
+  margin: 1.5rem 0;
+  padding: 0.75rem 1.25rem;
+  border-left: 4px solid var(--crs-blue);
+  border-radius: 4px;
+  background-color: var(--gray-200);
+
+  &__title {
+    margin: 0 0 0.5rem;
+    font-weight: 700;
+  }
+
+  summary.resources__title {
+    cursor: pointer;
+  }
+
+  &:not([open]) > summary.resources__title {
+    margin-bottom: 0;
+  }
+
+  &__list {
+    margin: 0;
+    padding-left: 1.25rem;
+
+    li {
+      margin: 0.2rem 0;
+    }
+
+    code {
+      overflow-wrap: anywhere;
+    }
+  }
+
+  &__size {
+    color: var(--gray-700);
+    font-size: 0.9em;
+    white-space: nowrap;
+  }
+}

assets/scss/shortcodes/_series-nav.scss

@@ -0,0 +1,40 @@
+/**/
+/* SERIES NAV: list of the parts of a blog series (layouts/_shortcodes/series-nav.html) */
+/**/
+
+.content .series-nav,
+.series-nav {
+  max-width: var(--content-width);
+  margin: 1.5rem 0;
+  padding: 0.75rem 1.25rem;
+  border-left: 4px solid var(--crs-blue-dark);
+  border-radius: 4px;
+  background-color: var(--gray-200);
+
+  &__title {
+    margin: 0 0 0.5rem;
+    font-weight: 700;
+  }
+
+  &__list {
+    margin: 0;
+    padding-left: 1.5rem;
+  }
+
+  &__item {
+    margin: 0.2rem 0;
+
+    &--current {
+      font-weight: 700;
+    }
+
+    &--soon {
+      color: var(--gray-700);
+    }
+  }
+
+  &__soon {
+    font-size: 0.9em;
+    font-style: italic;
+  }
+}

assets/scss/styles.scss

@@ -25,6 +25,8 @@
 @use "shortcodes/toc";
 @use "shortcodes/intro";
 @use "shortcodes/youtube-enhanced";
+@use "shortcodes/resources";
+@use "shortcodes/series-nav";
 @use "sponsors";
 @use "home";
 @use "highlight";

config/_default/hugo.yaml

@@ -42,4 +42,40 @@ markup:
         subscript:
           enable: true
         superscript:
-          enable: true
+          enable: true
+######################## module mounts ####################
+# Declaring any mount replaces Hugo's defaults, so the default project
+# mounts are listed first, unchanged.
+#
+# The remaining mounts publish the runnable example stacks under
+# examples/ as page resources of the blog posts that use them, so the
+# files live in one place and each post can list them with the
+# `resources` shortcode. Paths inside a bundle mirror the examples
+# directory (for example `elk/compose.yaml`).
+module:
+  mounts:
+    - source: content
+      target: content
+    - source: static
+      target: static
+    - source: layouts
+      target: layouts
+    - source: data
+      target: data
+    - source: assets
+      target: assets
+    - source: i18n
+      target: i18n
+    - source: archetypes
+      target: archetypes
+
+    # CRS logging series
+    - source: examples/crs-logging
+      target: content/blog/2026-11-03-crs-logging-part-1-what-your-waf-is-telling-you
+      includeFiles: ["generate-traffic.sh", "waf/**"]
+    - source: examples/crs-logging
+      target: content/blog/2026-11-10-crs-logging-part-2-elastic-stack
+      includeFiles: ["generate-traffic.sh", "waf/**", "elk/**"]
+    - source: examples/crs-logging
+      target: content/blog/2026-11-17-crs-logging-part-3-grafana-loki
+      includeFiles: ["generate-traffic.sh", "waf/RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf", "grafana-loki/**"]