From b738f38af8551021f77ad759425063d06e3c80de Mon Sep 17 00:00:00 2001
From: Mitja Felicijan <mitja.felicijan@gmail.com>
Date: Tue, 18 Jun 2024 18:43:56 +0200
Subject: Added first, last, random filters

---
 README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 773f233..a04c9de 100644
--- a/README.md
+++ b/README.md
@@ -158,6 +158,35 @@ Payload {
 })
 ```
 
+## Special filters
+
+- first (gets first N posts)
+- last (gets last N posts)
+- random (gets random N posts)
+
+```html
+<!-- First 10 pages -->
+{{ range first 10 .Pages }}
+  {{ if and (eq .Type "post") (not .Draft) }}
+    <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+  {{ end }}
+{{ end }}
+
+<!-- Last 10 pages -->
+{{ range last 10 .Pages }}
+  {{ if and (eq .Type "post") (not .Draft) }}
+    <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+  {{ end }}
+{{ end }}
+
+<!-- Random 10 pages -->
+{{ range random 10 .Pages }}
+  {{ if and (eq .Type "post") (not .Draft) }}
+    <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+  {{ end }}
+{{ end }}
+```
+
 ## License
 
 [jbmafp](https://github.com/mitjafelicijan/jbmafp) was written by [Mitja
-- 
cgit v1.2.3