From 8648169e959b6975e5c4ef3eaa279717df320272 Mon Sep 17 00:00:00 2001 From: joey Date: Sat, 10 Feb 2007 21:14:31 +0000 Subject: web commit by JoshTriplett: Optional parameters for shortcuts. --- doc/todo/shortcut_optional_parameters.mdwn | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 doc/todo/shortcut_optional_parameters.mdwn (limited to 'doc/todo/shortcut_optional_parameters.mdwn') diff --git a/doc/todo/shortcut_optional_parameters.mdwn b/doc/todo/shortcut_optional_parameters.mdwn new file mode 100644 index 000000000..494aac98a --- /dev/null +++ b/doc/todo/shortcut_optional_parameters.mdwn @@ -0,0 +1,24 @@ +Consider the "All files in this package search" on +. The URL for such a search looks like this: + + http://packages.debian.org/cgi-bin/search_contents.pl?word=packagename&searchmode=filelist&case=insensitive&version=unstable&arch=i386 + +To create a "debfiles" [[shortcut|shortcuts]] that takes a package name, you +could just hardcode the architecture and distribution: + + \[[shortcut name=debfiles url="http://packages.debian.org/cgi-bin/search_contents.pl?word=%s&searchmode=filelist&case=insensitive&version=unstable&arch=i386"]] + \[[debfiles ikiwiki]] + +But what if you could have them as optional parameters instead? The syntax +for the invocation should look like this: + + \[[debfiles ikiwiki dist=testing]] + +Some possible syntax choices for the shortcut definition: + + \[[shortcut name=debfiles url="http://packages.debian.org/cgi-bin/search_contents.pl?word=%s&searchmode=filelist&case=insensitive&version=%(dist)s&arch=%(arch)s" dist="unstable" arch="i386"]] + \[[shortcut name=debfiles url="http://packages.debian.org/cgi-bin/search_contents.pl?word=%s&searchmode=filelist&case=insensitive&version=%(dist=unstable)s&arch=%(arch=i386)s"]] + \[[shortcut name=debfiles url="http://packages.debian.org/cgi-bin/search_contents.pl?word=%s&searchmode=filelist&case=insensitive&version=%{dist=unstable}&arch=%{arch=i386}"]] + \[[shortcut name=debfiles url="http://packages.debian.org/cgi-bin/search_contents.pl?word=$*&searchmode=filelist&case=insensitive&version=${dist=unstable}&arch=${arch=i386}"]] + +--[[JoshTriplett]] -- cgit v1.2.3