 |
|
|
Meerkat: An Open Service API
Pages: 1, 2, 3, 4, 5
Recipes
And as if flavours weren't enough, you can also pass Meerkat various
parameters or arguments to hone in on just the stories you're interested in.
|
Parameter
|
Description
|
|
Query Properties
|
s
|
Search For
Instructs Meerkat to search for something in the story title or description.
The same effect as entering a search query into the search box in Meerkat's
standard control panel.
Settings: Either a + delimited list of keywords or a a // enclosed
regular expression.
Example: http://meerkat.oreillynet.com/?s=perl+apache
"stories whose title or description contains either perl or apache"
|
sw
|
Search What
By default, Meerkat's searches meander through story titles
and descriptions. This option instructs Meerkat instead to search
another field in particular. Currently supported are the Dublin Core
Metadata elements:
The same effect as choosing a field to search from Meerkat's
standard control panel.
Settings: {blank = title, description}, dc_title,
dc_creator, dc_subject, dc_description, dc_publisher,
dc_contributor, dc_date, dc_type, dc_format, dc_identifier,
dc_source, dc_language, dc_relation, dc_coverage, dc_rights
Example: http://meerkat.oreillynet.com/?s=perl+apache
"stories whose title or description contains either perl or apache"
Example: http://meerkat.oreillynet.com/?s=tim%20o'reilly&sw=dc_creator
"stories whose written by tim o'reilly" (spaces in
URLs are replaced by %20)
|
c
|
Channel
Instructs Meerkat to display only a particular channel.
The same effect as selecting a channel from the Categories/Channels menu in Meerkat's
standard control panel.
Settings: A numerical channel ID.
Example: http://meerkat.oreillynet.com/?c=1243
"stories from the 'oreillynet.python newsgroup".
|
t
|
Time Period
How far back Meerkat should look for stories. The same effect as choosing
a time period from Meerkat's standard control panel.
Settings: A number followed by one of: MINUTE,
HOUR, DAY, ALL. The number
is optional when choosing ALL.
Example: http://meerkat.oreillynet.com/?t=7DAY
"the past 7 days' worth of stories"
|
p
|
Profile
Restores the settings from a particular Meerkat profile, whether global
or yours personally. The same effect as choosing a profile to restore
from Meerkat's standard control panel.
Settings: The numerical ID of an existing profile.
Example: http://meerkat.oreillynet.com/?p=563
"stories caught by profile number 563 (The O'Reilly Network)"
|
m
|
Mob
Displays the stories associated with a particular Mob.
Settings: The numerical ID of an existing Mob (see "Manage my Mobs..." under
the Profiles/Mobs menu for your Mob's ID.
Example: http://meerkat.oreillynet.com/?m=123
"stories grouped under Mob number 123"
|
i
|
Id
Displays a particular story.
Settings: The numerical ID of an existing story. Hold your mouse over the
Mob (ring of dots) icon to see the story's id.
Example: http://meerkat.oreillynet.com/?i=456
"story number 456"
|
|
Display Properties
|
_fl
|
Flavour
Allows you to choose your preferred Meerkat Flavour or output format such
as 'meerkat' (the standard interface), 'xml', and 'php,' to name but a few.
Settings: A valid Meerkat flavour; see Meerkat
Flavours for a comprehensive listing.
Example: http://meerkat.oreillynet.com/?_fl=rss
"choose RSS flavouring; display the output as an RSS channel"
|
_de
|
Descriptions
Turn on or off story descriptions or blurbs. You lose some of the story
detail, but gain a compact display for easy scanning.
Settings: 0 = Off, 1 = On (default)
Example: http://meerkat.oreillynet.com/?_de=0
"hold the descriptions"
|
_ca
|
Categories
Meerkat's channels are cataloged into a category hierarchy; if these
categories aren't useful to you, feel free to turn 'em off.
Settings: 0 = Off, 1 = On (default) Note: Some Meerkat flavours
(e.g. RSS) may exclude the display of categories, ignoring this setting.
Example: http://meerkat.oreillynet.com/?_ca=0
"no categorization necessary, thank you"
|
_ch
|
Channels
Meerkat's stories are picked up from hundreds of channels. Don't really
care from which channel a particular story comes? Turn the channel display
off.
Settings: 0 = Off, 1 = On (default) Note: Some Meerkat flavours
(e.g. RSS) may exclude the display of categories, ignoring this setting.
Example: http://meerkat.oreillynet.com/?_ch=0
"turn off the display of channels"
|
_da
|
Dates
When Meerkat first noticed and picked up a story.
Settings: 0 = Off, 1 = On (default) Note: Some Meerkat flavours
(e.g. RSS) may exclude the display of categories, ignoring this setting.
Example: http://meerkat.oreillynet.com/?_da=0
"no thanks, I already have a date"
|
_dc
|
Dublin Core Metadata
Meerkat supports the RSS 1.0 RSS
1.0 Dublin Core module, augmenting RSS's standard title, link,
and description with such attributes as creator (author), subject,
rights, language, publisher, format, and so on.
Settings: 0 = Off, 1 = On (default) Note: Some Meerkat flavours
(e.g. Minimal) may exclude the display of Dublin Core Metadata,
ignoring this setting.
Example: http://meerkat.oreillynet.com/?_dc=0
"no thanks, title and description are enough for me"
|
You may have noticed ? marks next to some of the attributes in
the various Meerkat Flavours descriptions on page 3.
These indicate that display settings affect whether or not these
attributes are displayed. Unless specifically turned off, these attributes
will be displayed by default. Those without ? (Title and Link) cannot
be turned off.
Pages: 1, 2, 3, 4, 5
|
Next Page |
|
|
|
