ਫਰਮਾ:WebSlice-begin/doc ਲਈ ਸਰੋਤ ਵੇਖੋ

{{Documentation subpage}}
The {{tl|WebSlice-begin}} and {{tl|WebSlice-end}} templates can be used to create ''[[WebSlice#Web Slices|Web Slices]]'' out of certain content in a page. Web Slices are snippets of HTML content - marked up using <code>hAtom</code> and <code>hSlice</code> [[microformat]]s - that the browser keeps updated. The snippet can be viewed in the browser without navigating to the article - with all formatting applied. Web Slices currently work in [[Internet Explorer 8]] and [[Mozilla Firefox]] (the latter needs the [https://addons.mozilla.org/firefox/addon/8494 ''WebChunks''] extension).

==Usage==
To mark up a snippet as a Web Slice, add <code><nowiki>{{WebSlice-begin|id = n | title = WebSlice Title | expires = date/time}}</nowiki></code> before the section and <code><nowiki>{{WebSlice-end}}</nowiki></code> after the section. In the <code>id</code> field, specify a sequence number for the Web Slice. For example, add 1 for the first Web Slice, 2 for the second and so on. If it is not specified, it defaults to 1. In the <code>title</code> field, specify a human-readable title for the Web Slice. If it is not specified, the title of the page is used. The <code>expires</code> parameter is optional; it is used to specify when the syndicated content becomes no longer valid and informs the browser to stop updating the Web Slice. For example if you are monitoring the RfA tally, you can set the Web Slice to expire around the estimated closing time of the RfA.
:''Note - The expires parameter hasn't been implemented yet. Anyone willing to add support for it may look up the [http://msdn2.microsoft.com/en-us/library/cc304073(VS.85).aspx specification].

==Browser Support==
This feature currently only works on Internet Explorer 8 and Firefox with the webchunks addon. 

==Parameters==

===Required Parameters===
The following parameters are required:<ref name="overview">{{cite web|url=http://msdn.microsoft.com/en-us/library/cc196992(VS.85).aspx|title=Subscribing to Content with Web Slices |date=2010|publisher=[[MSDN]]|accessdate=5 February 2010}}</ref>

* '''id'''- The id must be a unique string (or integer) for that page. If you two web slices have the same id, then only the first one on that page will be recognized. Likewise, if the id changes, web browsers will be unable to update from the web slice.<ref name="overview" />

* '''title'''- The value of this will appear as the button text and will also appear in the "feeds discovery" button of IE. The title is limited to 128 characters.<ref name="overview" />

===Optional Parameters===
The following parameters are optional.

* '''ttl'''- The "time to live" value is the minimum time in minutes to update. How often to update in minutes. The minimum value is 15, anything smaller will be set to 15. (It doesn't always seem to follow the time you set...if below 120.) <ref name="overview" /><ref>http://msdn.microsoft.com/en-us/library/cc304073(VS.85).aspx</ref>

* '''endtime'''- The date and time that the web slice expires. Given in the ISO 8601 format or the RFC822 date format (with 4-digit years) Valid examples are:<ref name="overview" /><ref>http://feedvalidator.org/docs/error/InvalidRFC2822Date.html</ref><ref>http://php.net/manual/en/class.datetime.php</ref>
<pre>Valid time formats:
Mon, 15 Aug 05 15:52:01 +0000
22 Jul 2010 17:30:00 PDT
Wed, 02 Oct 2002 08:00:00 EST
Wed, 02 Oct 2002 13:00:00 GMT
Wed, 02 Oct 2002 15:00:00 +0200
</pre>
<!-- Implementing http://stackoverflow.com/questions/284775/how-do-i-parse-and-convert-datetimes-to-the-rfc-822-date-time-format-->

The ''' Alternative Display Source''', '''Alternative Navigation property''' and '''Alternative Update Source''' are net yet supported for security reasons.

==References==
==ਹਵਾਲੇ==
{{ਹਵਾਲੇ}}

==External links==
* [http://msdn.microsoft.com/en-us/library/cc196992(VS.85).aspx Subscribing to Content with Web Slices], MSDN
* [http://msdn.microsoft.com/en-us/library/cc304073(VS.85).aspx Web Slice Format Specification - Version 0.9], MSDN
* [http://msdn.microsoft.com/en-us/library/cc956158(VS.85).aspx Web Slices], MSDN
* [http://www.youtube.com/watch?v=aqXR79P_Uzo Internet Explorer 8 Web Slices], [[Youtube]]