summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/examples/blog/posts.mdwn2
-rw-r--r--doc/plugins/inline.mdwn4
-rw-r--r--doc/todo/Shorter_feeds.mdwn9
3 files changed, 13 insertions, 2 deletions
diff --git a/doc/examples/blog/posts.mdwn b/doc/examples/blog/posts.mdwn
index e4b053d8f..f5b128df0 100644
--- a/doc/examples/blog/posts.mdwn
+++ b/doc/examples/blog/posts.mdwn
@@ -1,3 +1,3 @@
Here is a full list of posts to my [[blog|index]].
-[[inline pages="*blog/posts/* and !*/Discussion" archive=yes quick=yes]]
+[[inline pages="*blog/posts/* and !*/Discussion" archive=yes feedshow=10 quick=yes]]
diff --git a/doc/plugins/inline.mdwn b/doc/plugins/inline.mdwn
index cfea8006e..cd76fd286 100644
--- a/doc/plugins/inline.mdwn
+++ b/doc/plugins/inline.mdwn
@@ -18,6 +18,10 @@ directive:
* `show` - Specify the maximum number of matching pages to inline.
Default is 10, unless archiving, when the default is to show all.
Set to 0 to show all matching pages.
+* `feedshow` - Specify the maximum number of matching pages to include in
+ the rss/atom feeds. The default is the same as the `show` value above,
+ and it cannot be larger than that value, but can be set to a smaller
+ value to avoid producing excessively large feed files.
* `skip` - Specify a number of pages to skip displaying. Can be useful
to produce a feed that only shows archived pages.
* `rss` - controls generation of an rss feed. On by default if the wiki is
diff --git a/doc/todo/Shorter_feeds.mdwn b/doc/todo/Shorter_feeds.mdwn
index 0966bc216..2e0b0fab9 100644
--- a/doc/todo/Shorter_feeds.mdwn
+++ b/doc/todo/Shorter_feeds.mdwn
@@ -1,4 +1,11 @@
-It should be possible to control the number of items included in a feed independently of the number of items included on the page (the latter, however, possibly setting an upper limit). This would be particularly useful on archive pages providing a feed. Presently the feed grows huge, if the archive page has no limit on the entries listed on it (as in the list of [all entries][ionfaq] in the Ion FAQ). An alternative useful filter would be filtering by the age of the page.
+It should be possible to control the number of items included in a feed
+independently of the number of items included on the page (the latter,
+however, possibly setting an upper limit). This would be particularly
+useful on archive pages providing a feed. Presently the feed grows huge, if
+the archive page has no limit on the entries listed on it (as in the list
+of [all entries][ionfaq] in the Ion FAQ). An alternative useful filter
+would be filtering by the age of the page.
[ionfaq]: http://iki.fi/tuomov/ion/faq/entries.html
+> [[todo/Done]], option name is `feedshow` --[[Joey]]