User:Who R you?/sandbox4

blekko

Documentation[view] [edit] [history] [purge]

Usage

Creates a blekko search link for the specified query.  If only the trailing "|" pipe character is specified and the search query is omitted, searches for the name of the page containing the template.  By default, searches in the predefined Reliable Sources search scope (slashtag /wprs/rs); but alternative slashtag(s) may be specified.

  {{blekko | Query | Slashtag | Caption | Secure | Style }}

Parameter		Name	Description	Default
# 1		Query	Search Query	blekko article (if missing)  or  searches current page name (if blank)
	• If Query is missing (i.e. if "|" pipe is omitted), click opens Wikipedia's "blekko" article • If Query is blank (i.e. "|" pipe only (with or without whitespace)) the current page name is searched for • Multiple search terms may be separated by a space " " or plus "+"     (e.g. {{blekko| a b }} or {{blekko| a+b }} ) • To search for a specific sequence of words, enclose the text in quotation marks (" ")     (e.g. {{blekko| "a b" }} matches "a book" or "a baseball" but not "Abba babba" )
# 2		Slashtag	Scope of the web to be searched	/wprs/rs
	• Predefined /wprs/ slashtags may be used by specifying only the last portion of the slashtag name:     (i.e. rs for /wprs/rs or strict for /wprs/strict ). • Global blekko slashtags may be used by starting with a slash " / ":     (i.e. /news for /blekko/news or /colleges for /blekko/colleges ). • Multiple slashtags may be specified and should be separated by a space " "; • Slashtags may be excluded from the results by preceding with "−"; and  • If specifying multiple slashtags, the full slashtag name (i.e. /wprs/rs or /blekko/news, etc) must be specified.     (e.g. {{blekko| Query |/wprs/rs /blekko/tech −/blekko/colleges}} ) • Any other blekko user defined public slashtag may be used by specifying the full slashtag:     (i.e. /SomeBlekkoUser/TheirSlashtagName ). • Specify a slashtag of all or none for a full blekko search of the entire web (excluding spam sites and datafarms).  This calls blekko without setting a slashtag.
# 3		Caption	Link Caption to be clicked	blekko
	• The link text which appears in color and underlined. ← Not a Link — An Example • If Link Caption is not specified, the stylized caption blekko is used. • If Link Caption is specified but blank (i.e. the "|" pipe is specified), the Search Query is used as the caption.
# 4		Secure	Secure connection	(http://) non−secure
	• {blank} or {missing} for non−secure (http://) connection, or   "s" (or anything else) to indicate secure (https://) searching. • Links continue to open in a separate window based on Preferences → Gadget → Browsing → Open external links in a new tab/window setting. • Standard assignment of HTML plainlinks class continues to suppress icon after link−caption.
# 5		Style	Style
	• Standard HTML/CSS style codes may be added to adjust the Link Caption appearance. • Do not use quotation marks, just enter the HTML/CSS Style codes without quotes.     (e.g.  background-color:black; color:white; ).

Notes

If Search Query contains a slash ("/"), it must be enclosed in quotation marks; otherwise unexpected results may occur as any text following the / may be treated as a slashtag.
"whitespace" indicates any continuous combination of single or multiple spaces, tabs, linefeeds, etc.  (i.e. No letters, numbers, symbols, etc). A non-breaking space ( ) is not whitespace and parameters containing such are treated as non-blank.
"blank" indicates that the parameter is specified, by the use of the "|" pipe symbol, but no value is assigned.
	(i.e. In both sequences "param1||param3" and "param1|  |param3" → param2 is blank)
"missing" indicates that a parameter which could be specified is not.
	(i.e. If 3 parameters are valid, then in the following sequences
	"param1|" → param2 is blank and param3 is missing;
	"param1" → param2 & param3 are both missing;
	"param1||" → param2 & param3 are both blank.)

Examples

Sample Template Code	Displays	Result
{{blekko}}	blekko	Opens the blekko Wikipedia article. Same as [[blekko]].
{{blekko|}}	blekko	Opens the blekko search and searches for "sandbox4" (the current page name) in the default slashtag ( /wprs/rs ).
{{blekko| }}	blekko	Opens the blekko search with the default slashtag ( /wprs/rs ).
{{blekko|Hello}}	blekko	Does a blekko search for "Hello" in Reliable Sources ( /wprs/rs ).
{{blekko|Hello|}}	blekko	Same as above.  Regardless of the trailing "|" here.
{{blekko|Hello|strict}}	blekko	Does a blekko search for "Hello" in Strict Sources ( /wprs/strict ).
{{blekko|Hello|strict|}}	Hello	Same search as above.  Note that the Search Query is used as the Link Caption since the "|" was specified but no Link Caption was passed.
{{blekko|Hello|strict| }}		Same search as above.  Note that nothing appears except the open in window icon for this Link because a non−breaking space ( ) was passed as the Link Caption.  If the plainlinks class is used, nothing is visible to indicate a link unless the cursor hovers over the area of the space.
{{blekko|Hello|strict|Link Caption}}	Link Caption	Same search as above but displays a custom Link Caption.
{{blekko|Hello|strict|Link Caption|}}	Link Caption	Same as above, regardless of trailing "|" here.
{{blekko|Hello|strict|Link Caption| }}	Link Caption	Same as above.  Whitespace is ignored in parameter 4 (Secure).
{{blekko|Hello|strict|Link Caption| }}	Link Caption	Still searches for "Hello" in the Strict Sources slashtag as above.  Since parameter 4 (Secure) is not blank or missing (a non−breaking space is not a blank), search is conducted over an https:// secure internet connection.  Recommended "s" or "S" be used in parameter # 4 (secure) as an intuitive reminder of parameter function, and for future enhancements.
{{blekko|Hello|strict|Link Caption|S}}	Link Caption	Same as above.  If anything other than whitespace is specified for parameter 4 (Secure), an https:// secure connection is used.
{{blekko|Hello|strict|Link Caption|z|font-size:1.5em;}}	Link Caption	Same secure search as above, but font size of Link Caption is expanded 1½ times normal page font.
{{blekko|Hello|strict||z| color:Green;}}	Hello	Same secure search as above; however, since Link Caption is omitted, the Query is used as the link caption; and it's styled Green.
{{blekko|Hello||||font-size:0.6em;}}	Hello	Searches the default slashtag ( /wprs/rs ) for "Hello" using the default http:// connection.  Since Link Caption is omitted, the Search Query is used as the link caption as well and here it's styled 60% size.
{{blekko|Wikipedia||Wikipedia|s|font-size:1.5em;}}	Wikipedia	Searches the default Reliable Sources slashtag ( /wprs/rs ) for "Wikipedia"; the font is enlarged.  Uses a secure https:// connection for the query.
{{blekko|Wikipedia|strict||S|font-size:1.5em; letter-spacing:2px;}}	Wikipedia	Searches strict sources ( /wprs/strict ) for "Wikipedia"; the link caption is styled with enlarged font and spread letter spacing.  A secure https:// connection is again used.
{{blekko|Wikipedia|/all|||"font-size:1.5em; letter-spacing:3px;"}}	Wikipedia	Searches the full web for all matches of "Wikipedia" (excluding sites identified by blekko as datafarms and spam sites).  The default http:// connection is used.  Note: The style code is ignored because it is enclosed in quotes.
{{blekko||none|||letter-spacing:3px;}}	sandbox4	Searches the full web for all matches of "sandbox4" (the current page name); the link caption (which is the same as the current page name because Link Caption was specified but blank) is styled with wide spacing.
{{blekko|Style=background-color:yellow;| Slashtag=none|Query=}}	blekko	Named parameters are used for Style to set the background colour, hiliting the link, for Slashtag, to force a blekko full web search, and for Query, to specify, but leave blank, the query, causing current pagename to be searched.
{{blekko|Caption=|Query=}}	sandbox4	Searches the current page name ("sandbox4" here), and specifies, but leaves blank, the Link Caption parameter causing the Query ("sandbox4") to be used for the link.
{{blekko|Caption=CAPTION| Query=Wikipedia|Style=font-weight:bold;}}	CAPTION	Sets the Link Caption to CAPTION (bolded), and searches in reliable sources for "Wikipedia".
{{blekko|Caption=WP's blekko}}	WP's blekko	Sets the Link Caption to "WP's blekko"; opens Wikipedia Blekko article since Query is not set.
{{blekko|Query=Hello}}	blekko	Does a blekko search for "Hello" in Reliable Sources ( /wprs/rs ).  Same as the 4th example.

Slashtags

The following wprs slashtags are defined in blekko:

Slashtag	Scope
rs	/blekko/colleges, /blekko/news, /blekko/ebooks, /blekko/national-labs, /blekko/supreme-court
strict	/blekko/colleges, /blekko/news, /blekko/supreme-court

The above documentation is transcluded from User:Who R you?/sandbox4/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this page.