feat: add Eleventy configuration and role template partials

- Update .eleventy.js with role filtering functions (byRole, byAnyRole)
- Add role-group-sections.njk partial for displaying role groups
- Add role-mini-toc.njk partial for role navigation
- Enable role-based content filtering across the site

Author: shawnthompson

.eleventy.js

@@ -195,6 +195,45 @@ module.exports = function (eleventyConfig) {
     return changedPages; // Returning the changed URLs, titles, and locales for the template
   });
 
+  // Get the role keys that belong to a given group
+  eleventyConfig.addFilter("roleKeysForGroup", function (groupKey, rolesData) {
+    if (!groupKey || !rolesData || !rolesData.roles) return [];
+    return Object.entries(rolesData.roles)
+      .filter(([, meta]) => meta.group === groupKey)
+      .map(([key]) => key);
+  });
+
+  // Given a list of role keys, return all pages that match ANY of them
+  eleventyConfig.addFilter("byAnyRole", function (collection, roleKeys) {
+    if (!collection || !roleKeys || !roleKeys.length) return [];
+    return collection.filter((item) => {
+      const r = item.data.role;
+      if (!r) return false;
+      const arr = Array.isArray(r) ? r : [r];
+      return arr.some((k) => roleKeys.includes(k));
+    });
+  });
+
+  // Collection of all pages that have at least one role
+  eleventyConfig.addCollection("rolePages", (api) =>
+    api.getAll().filter((item) => !!item.data.role)
+  );
+
+  // Custom collection for role groups to work around pagination tag issues
+  eleventyConfig.addCollection("roleGroup", (api) => {
+    // Find all pages generated from the roles-group.njk template OR
+    // pages with URLs matching role group patterns
+    return api.getAll().filter((item) => {
+      // Check if the page was generated from the roles-group template
+      const fromRoleGroupTemplate = item.inputPath && item.inputPath.includes('roles-group.njk');
+
+      // Check if URL matches role group pattern (e.g., /en/roles/business/, /fr/roles/design/)
+      const matchesRoleGroupPattern = item.url && item.url.match(/^\/(en|fr)\/roles\/(administration|author|business|design|development|testing)\/$/);
+
+      return fromRoleGroupTemplate || matchesRoleGroupPattern;
+    });
+  });
+
   // Add custom Markdown filter for Nunjucks
   eleventyConfig.addNunjucksFilter("markdown", function (value) {
     return md.render(value);

src/_includes/partials/role-group-sections.njk

@@ -0,0 +1,41 @@
+{# expects: lang, locale, rolesData, groupRoleKeys, collections, pathPrefix, landingPage, alerts #}
+{% for rk in groupRoleKeys %}
+{% set label = rolesData.labels[lang][rk] or rk %}
+{% set anchor = label | stripTagsSlugify %}
+{% set items = collections.rolePages
+| byAnyRole([rk])
+| localeMatch(locale)
+| sort(false, false, 'data.title') %}
+
+{% if items.length %}
+<section class="mrgn-bttm-xl">
+	<h2 id="{{ anchor }}">{{ label }}</h2>
+	<p><a href="{{ pathPrefix }}{{ permalinkPrefix }}{{ locale }}/roles/{{ rk }}/">{% if lang == 'fr' %}Aller à la page {{ label | lower }} <small class="text-muted">({{ items.length }})</small>{% else %}Go to {{ label | lower }} page <small class="text-muted">({{ items.length }})</small>{% endif %}</a></p>
+	<div class="row wb-eqht mrgn-tp-lg gc-drmt">
+		{% for item in items %}
+		<div class="col-md-6">
+			<h3 class="h4">
+				<a{% if item.data.redirect %} rel="external" {% endif %}
+					 href="{% if item.data.redirect %}{{ item.data.redirect }}{% else %}{{ pathPrefix }}{{ item.url }}{% endif %}"
+					 {% if item.data.oneLanguage %} hreflang="{{ landingPage[locale].otherLang }}" {% endif %}>
+					{% if item.data.internal === true %}
+					<span class="fas fa-external-link-square-alt mrgn-lft-sm mrgn-rght-sm" aria-hidden="true"></span>
+					<span class="wb-inv"> {{ alerts[locale].hiddenTextLink }}</span>
+					{% endif %}
+					{{ item.data.title | safe }}
+					{% if item.data.oneLanguage %}<small> {{ landingPage[locale].otherLangOnly }}</small>{% endif %}
+					</a>
+			</h3>
+			<p>
+				{% if item.data.description %}
+				{{ item.data.description | safe }}
+				{% else %}
+				{{ landingPage[locale].descriptionNoneText }}
+				{% endif %}
+			</p>
+		</div>
+		{% endfor %}
+	</div>
+</section>
+{% endif %}
+{% endfor %}

src/_includes/partials/role-mini-toc.njk

@@ -0,0 +1,20 @@
+{# expects: lang, locale, rolesData, groupRoleKeys, collections #}
+<aside>
+	<h2>{{ onThisPage[locale].heading }}</h2>
+	<ul class="mrgn-bttm-lg">
+		{% for rk in groupRoleKeys %}
+		{% set label = rolesData.labels[lang][rk] or rk %}
+		{% set anchor = label | stripTagsSlugify %}
+		{% set items = collections.rolePages
+		| byAnyRole([rk])
+		| localeMatch(locale)
+		| sort(false, false, 'data.title') %}
+		{% if items.length %}
+		<li class="list-inline-item">
+			<a href="#{{ anchor }}">{{ label }}</a>
+			<small class="text-muted">({{ items.length }})</small>
+		</li>
+		{% endif %}
+		{% endfor %}
+	</ul>
+</aside>