feat: Render FIP Validity from params

MoritzWeber0 · MoritzWeber0 · commit b7b72f6de0b3 · 2025-11-21T18:01:29.000+01:00
diff --git a/archetypes/operator/index.en.md b/archetypes/operator/index.en.md
@@ -8,6 +8,11 @@ country:
   - "country2"
   - "country3"
 operator: "{{ .File.ContentBaseName }}"
+Params:
+  fip_coupon: true # <true/false>
+  fip_coupon_relatives: false # <true/false>
+  fip_50_ticket: true # <true/false>
+  fip_global_fare: true # <true/false>
 ---
 
 <!-- Remove the WIP snippet if the page is complete -->
@@ -30,15 +35,14 @@ operator: "{{ .File.ContentBaseName }}"
 
 ## Validity of FIP Tickets
 
+{{< fip-validity >}}{{< /fip-validity >}}
+
 <!--
-  The ticket categories may vary depending on the operator.
+  The fip-validity shortcode reads from the Params in the frontmatter.
+  You can add additional notes inside the shortcode tags (e.g., links to specific sections).
+  Example: {{< fip-validity >}}(For international trains, see [section](#anchor)){{< /fip-validity >}}
 -->
 
-FIP Coupon: <✅/⛔> \
-FIP Coupon for relatives: <✅/⛔> \
-FIP 50 Tickets: <✅/⛔> \
-FIP Global Fare: <✅/⛔>
-
 <!--
   Where are FIP 50 Tickets/FIP Coupons valid and are there any restrictions? Which ticket is required for entry (e.g., continuous FIP 50 ticket or FIP Coupons of both countries)?
 -->
diff --git a/assets/sass/fipValidity.scss b/assets/sass/fipValidity.scss
@@ -0,0 +1,44 @@
+.o-fip-validity {
+  display: flex;
+  flex-direction: column;
+  gap: 0.8rem;
+  margin-bottom: 1.2rem;
+
+  &__tags {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.6rem;
+  }
+
+  &__footnotes {
+    display: flex;
+    flex-direction: column;
+    gap: 0.4rem;
+    font-size: 0.9em;
+  }
+
+  &__footnote {
+    display: flex;
+    gap: 0.4rem;
+    align-items: baseline;
+  }
+
+  &__footnote-number {
+    font-weight: 600;
+    flex-shrink: 0;
+  }
+
+  &__footnote-text {
+    p {
+      margin: 0;
+      display: inline;
+    }
+  }
+
+  &__note {
+    p {
+      margin: 0;
+      display: inline;
+    }
+  }
+}
diff --git a/assets/sass/main.scss b/assets/sass/main.scss
@@ -19,3 +19,4 @@
 @import "dropdown.scss";
 @import "trainCategory.scss";
 @import "tag.scss";
+@import "fipValidity.scss";
diff --git a/assets/sass/tag.scss b/assets/sass/tag.scss
@@ -15,4 +15,8 @@
       border: 0.1rem solid var(--tag-#{$name}-border);
     }
   }
+
+  &__footnote {
+    font-weight: 600;
+  }
 }
diff --git a/assets/sass/trainCategory.scss b/assets/sass/trainCategory.scss
@@ -32,6 +32,10 @@ details.o-expander--train-category:not([open]) {
     .a-tag__text {
       display: none;
     }
+
+    .a-tag__footnote {
+      display: none;
+    }
   }
 }
 
diff --git a/content/operator/sncf/index.de.md b/content/operator/sncf/index.de.md
@@ -10,6 +10,11 @@ country:
   - "belgium"
   - "luxembourg"
 operator: "sncf"
+Params:
+  fip_coupon: true
+  fip_coupon_relatives: false
+  fip_50_ticket: true
+  fip_global_fare: true
 ---
 
 Die SNCF (Société Nationale des Chemins de fer Français) ist die französische Staatsbahn und die wichtigste Bahngesellschaft in Frankreich. Sie betreibt fast alle Fern- und Regionalzüge in Frankreich.
@@ -24,10 +29,7 @@ Die SNCF (Société Nationale des Chemins de fer Français) ist die französisch
 
 ## Gültigkeit FIP Tickets
 
-FIP Freifahrtschein: ✅ \
-FIP Freifahrt Angehörige: ⛔ \
-FIP 50 Tickets: ✅ \
-FIP Globalpreis: ✅ (Für internationale `TGV` Züge, siehe [Grenzüberschreitende TGV inOui / ICE Züge](#grenzüberschreitende-tgv-inoui--ice-züge))
+{{< fip-validity fip_global_fare_footnote="Für internationale `TGV` Züge, siehe [Grenzüberschreitende TGV inOui / ICE Züge](#grenzüberschreitende-tgv-inoui--ice-züge)" />}}
 
 FIP Freifahrtscheine und FIP 50 Tickets sind auf Verbindungen der SNCF gültig. Bei grenzüberschreitenden Fahrten im Nahverkehr muss entweder ein durchgängiges FIP 50 Ticket oder FIP Freifahrtscheine beider Länder vorhanden sein. Auf internationalen Fernverkehrsverbindungen mittels `TGV` oder `ICE` gelten jedoch Globalpreise, siehe [Grenzüberschreitende TGV inOui / ICE Züge](#grenzüberschreitende-tgv-inoui--ice-züge).
 
diff --git a/content/operator/sncf/index.en.md b/content/operator/sncf/index.en.md
@@ -10,6 +10,11 @@ country:
   - "belgium"
   - "luxembourg"
 operator: "sncf"
+Params:
+  fip_coupon: true
+  fip_coupon_relatives: false
+  fip_50_ticket: true
+  fip_global_fare: true
 ---
 
 SNCF (Société Nationale des Chemins de fer Français) is the French national railway company and the main rail operator in France. It operates almost all long-distance and regional trains in France.
@@ -24,10 +29,7 @@ SNCF (Société Nationale des Chemins de fer Français) is the French national r
 
 ## Validity of FIP Tickets
 
-FIP Coupon: ✅ \
-FIP Coupon for relatives: ⛔ \
-FIP 50 Ticket: ✅ \
-FIP Global Fare: ✅ (For international `TGV` trains, see [International TGV inOui / ICE trains](#international-tgv-inoui--ice-trains))
+{{< fip-validity fip_global_fare_footnote="For international `TGV` trains, see [International TGV inOui / ICE trains](#international-tgv-inoui--ice-trains)" />}}
 
 FIP Coupons and FIP 50 Tickets are valid on SNCF services. For cross-border journeys on local trains, either a continuous FIP 50 Ticket or FIP Coupons for both countries are required. For international long-distance services (`TGV` or `ICE`), global fares apply (see [International TGV inOui / ICE trains](#international-tgv-inoui--ice-trains)).
 
diff --git a/content/operator/sncf/index.fr.md b/content/operator/sncf/index.fr.md
@@ -10,6 +10,11 @@ country:
   - "belgium"
   - "luxembourg"
 operator: "sncf"
+Params:
+  fip_coupon: true
+  fip_coupon_relatives: false
+  fip_50_ticket: true
+  fip_global_fare: true
 ---
 
 La SNCF (Société Nationale des Chemins de fer Français) est la compagnie ferroviaire nationale française et le principal opérateur ferroviaire en France. Elle exploite la quasi-totalité des trains grandes lignes et régionaux du pays.
@@ -24,10 +29,7 @@ La SNCF (Société Nationale des Chemins de fer Français) est la compagnie ferr
 
 ## Validité des Billets FIP
 
-Coupon FIP : ✅ \
-Coupon FIP accompagnant : ⛔ \
-Billet FIP 50 : ✅ \
-Tarif Global FIP : ✅ (pour les trains internationaux `TGV`, voir [Trains TGV inOui / ICE internationaux](#trains-tgv-inoui--ice-internationaux))
+{{< fip-validity fip_global_fare_footnote="pour les trains internationaux `TGV`, voir [Trains TGV inOui / ICE internationaux](#trains-tgv-inoui--ice-internationaux)" />}}
 
 Les Coupons FIP et Billets FIP 50 sont valables sur les services SNCF. Pour les trajets transfrontaliers en trains régionaux, il faut soit un Billet FIP 50 continu, soit des Coupons FIP valables dans chaque pays. Sur les trains grandes lignes internationaux (`TGV` ou `ICE`), des Tarifs Globaux s’appliquent (voir [Trains TGV inOui / ICE internationaux](#trains-tgv-inoui--ice-internationaux)).
 
diff --git a/i18n/de.yaml b/i18n/de.yaml
@@ -33,6 +33,11 @@ country:
   other: Länder
 discord: FIP Guide Community
 editPage: Seite bearbeiten
+fipValidity:
+  fip-50-ticket: FIP 50 Ticket
+  fip-coupon: FIP Freifahrtschein
+  fip-coupon-relatives: FIP Freifahrt Angehörige
+  fip-global-fare: FIP Globalpreis
 footer-love:
   aria-label: Made with love in Europe
   text: Made with ♥️ in Europe
diff --git a/i18n/en.yaml b/i18n/en.yaml
@@ -32,6 +32,11 @@ country:
   other: countries
 discord: FIP Guide Community
 editPage: Edit page
+fipValidity:
+  fip-50-ticket: FIP 50 Ticket
+  fip-coupon: FIP Coupon
+  fip-coupon-relatives: FIP Coupon for relatives
+  fip-global-fare: FIP Global Fare
 footer-love:
   aria-label: Made with love in Europe
   text: Made with ♥️ in Europe
diff --git a/i18n/fr.yaml b/i18n/fr.yaml
@@ -33,6 +33,11 @@ country:
 countryselection: Choisir un pays
 discord: Communauté FIP Guide
 editPage: Modifier la page
+fipValidity:
+  fip-50-ticket: Billet FIP 50
+  fip-coupon: Coupon FIP
+  fip-coupon-relatives: Coupon FIP accompagnant
+  fip-global-fare: Tarif Global FIP
 footer-love:
   aria-label: Fait avec amour en Europe
   text: Fait avec ♥️ en Europe
diff --git a/layouts/partials/tag.html b/layouts/partials/tag.html
@@ -1,4 +1,8 @@
 <span class="a-tag a-tag--{{ .Type }}">
   {{ partial "icon" .Icon }}
-  <span class="a-tag__text">{{ i18n .Text }}</span>
+  <span class="a-tag__text"
+    >{{ i18n .Text }}{{- with .Footnote -}}
+      <sup class="a-tag__footnote">{{ . }}</sup>
+    {{- end -}}</span
+  >
 </span>
diff --git a/layouts/shortcodes/fip-validity.html b/layouts/shortcodes/fip-validity.html
@@ -0,0 +1,108 @@
+{{- $page := .Page -}}
+{{- $footnotes := dict -}}
+
+{{- with .Get "fip_coupon_footnote" -}}
+  {{- $footnotes = merge $footnotes (dict "fip_coupon" .) -}}
+{{- end -}}
+{{- with .Get "fip_coupon_relatives_footnote" -}}
+  {{- $footnotes = merge $footnotes (dict "fip_coupon_relatives" .) -}}
+{{- end -}}
+{{- with .Get "fip_50_ticket_footnote" -}}
+  {{- $footnotes = merge $footnotes (dict "fip_50_ticket" .) -}}
+{{- end -}}
+{{- with .Get "fip_global_fare_footnote" -}}
+  {{- $footnotes = merge $footnotes (dict "fip_global_fare" .) -}}
+{{- end -}}
+
+{{- $footnoteCounter := 0 -}}
+{{- $footnoteMap := dict -}}
+
+
+<div class="o-fip-validity">
+  <div class="o-fip-validity__tags">
+    {{- if isset $page.Params "fip_coupon" -}}
+      {{- $accepted := $page.Params.fip_coupon -}}
+      {{- $footnoteNum := "" -}}
+      {{- if isset $footnotes "fip_coupon" -}}
+        {{- $footnoteCounter = add $footnoteCounter 1 -}}
+        {{- $footnoteNum = printf "%d)" $footnoteCounter -}}
+        {{- $footnoteMap = merge $footnoteMap (dict (string $footnoteCounter) (index $footnotes "fip_coupon")) -}}
+      {{- end -}}
+      {{- partial "tag" (
+        dict
+        "Icon" (cond $accepted "check_circle" "cancel")
+        "Text" "fipValidity.fip-coupon"
+        "Type" (cond $accepted "success" "error")
+        "Footnote" $footnoteNum
+        )
+      }}
+    {{- end -}}
+
+    {{- if isset $page.Params "fip_coupon_relatives" -}}
+      {{- $accepted := $page.Params.fip_coupon_relatives -}}
+      {{- $footnoteNum := "" -}}
+      {{- if isset $footnotes "fip_coupon_relatives" -}}
+        {{- $footnoteCounter = add $footnoteCounter 1 -}}
+        {{- $footnoteNum = printf "%d)" $footnoteCounter -}}
+        {{- $footnoteMap = merge $footnoteMap (dict (string $footnoteCounter) (index $footnotes "fip_coupon_relatives")) -}}
+      {{- end -}}
+      {{- partial "tag" (
+        dict
+        "Icon" (cond $accepted "check_circle" "cancel")
+        "Text" "fipValidity.fip-coupon-relatives"
+        "Type" (cond $accepted "success" "error")
+        "Footnote" $footnoteNum
+        )
+      }}
+    {{- end -}}
+
+    {{- if isset $page.Params "fip_50_ticket" -}}
+      {{- $accepted := $page.Params.fip_50_ticket -}}
+      {{- $footnoteNum := "" -}}
+      {{- if isset $footnotes "fip_50_ticket" -}}
+        {{- $footnoteCounter = add $footnoteCounter 1 -}}
+        {{- $footnoteNum = printf "%d)" $footnoteCounter -}}
+        {{- $footnoteMap = merge $footnoteMap (dict (string $footnoteCounter) (index $footnotes "fip_50_ticket")) -}}
+      {{- end -}}
+      {{- partial "tag" (
+        dict
+        "Icon" (cond $accepted "check_circle" "cancel")
+        "Text" "fipValidity.fip-50-ticket"
+        "Type" (cond $accepted "success" "error")
+        "Footnote" $footnoteNum
+        )
+      }}
+    {{- end -}}
+
+    {{- if isset $page.Params "fip_global_fare" -}}
+      {{- $accepted := $page.Params.fip_global_fare -}}
+      {{- $footnoteNum := "" -}}
+      {{- if isset $footnotes "fip_global_fare" -}}
+        {{- $footnoteCounter = add $footnoteCounter 1 -}}
+        {{- $footnoteNum = printf "%d)" $footnoteCounter -}}
+        {{- $footnoteMap = merge $footnoteMap (dict (string $footnoteCounter) (index $footnotes "fip_global_fare")) -}}
+      {{- end -}}
+      {{- partial "tag" (
+        dict
+        "Icon" (cond $accepted "check_circle" "cancel")
+        "Text" "fipValidity.fip-global-fare"
+        "Type" (cond $accepted "success" "error")
+        "Footnote" $footnoteNum
+        )
+      }}
+    {{- end -}}
+  </div>
+
+  {{- if gt (len $footnoteMap) 0 -}}
+    <div class="o-fip-validity__footnotes">
+      {{- range $index, $text := $footnoteMap -}}
+        <div class="o-fip-validity__footnote">
+          <span class="o-fip-validity__footnote-number">{{ $index }})</span>
+          <span class="o-fip-validity__footnote-text"
+            >{{ $text | $page.RenderString }}</span
+          >
+        </div>
+      {{- end -}}
+    </div>
+  {{- end -}}
+</div>

Original file line number	Diff line number	Diff line change
`@@ -15,4 +15,8 @@`
`15`	`15`	`border: 0.1rem solid var(--tag-#{$name}-border);`
`16`	`16`	`}`
`17`	`17`	`}`
	`18`	`+`
	`19`	`+ &__footnote {`
	`20`	`+ font-weight: 600;`
	`21`	`+ }`
`18`	`22`	`}`
Original file line number	Diff line number	Diff line change
`@@ -32,6 +32,10 @@ details.o-expander--train-category:not([open]) {`
`32`	`32`	`.a-tag__text {`
`33`	`33`	`display: none;`
`34`	`34`	`}`
	`35`	`+`
	`36`	`+ .a-tag__footnote {`
	`37`	`+ display: none;`
	`38`	`+ }`
`35`	`39`	`}`
`36`	`40`	`}`
`37`	`41`