Bersyong Orihinal: W3C Orihinal
Translator: Eric Abordo. Manager: Joseph Plazo

Ang original na texto ay kinupkop ng internasyonal na copyright. Pakituon ng pansin ang original na reperensya mula sa mga hyperlinks para sa mas malalim na pagkaunawa."This translated text may contain conversion errors. Please refer to the original document at WC3 for normative version."

Ang Paggawa ng W3C RSS 1.0 News Feed

Eric Miller et al.

24 January 2001

last rev. $Date: 2003/04/29 14:53:05 $

Mga Nilalaman: Mabilis na cheatsheet · RSS 1.0 · Payak na HTML Markup para sa generasyon ng RSS 1.0 generation · Paglalahad ng Markup · Gawin nyo · Mga Links

Mabilis na cheatsheet

Kung gusto mong magdagdag sa kapasidad para sa RSS feed para sa sarili mong pahina, sa launting trabaho lang, ito ang quick list ng gapat mong gawin.

Siguraduhin na ang html/head/title element ay naglalaman ng plausible data; ito ay gagamitin sa titulo ng RSS news feed.
Kung ang pahinang ay naglalaman ng maikling high-level description ng suheto, itag ito bilang span na may class="description.
Kung ang pahina ay di naglalaman ng maikling high-level description ng suheto, idagdag ito, at itag . Itong description ay gagamitin na description ng RSS channel.
Kung mayroon kang section ng mga news items , gamitin ang markup na inilarawansa ibaba para maitag ang mga items.
Kung wala kang section ng news items, magadagdag ng isa at itag ang mga items gamit ang markup sa ibaba. (Alalahanin na ito ay di, kahigpitang, esensyal, pero ito ay napakadaling gamitin sa system na inilarawan rito kung mayroon kang whats-new section sa pahina kaysa kung ikaw ay susubok gamitin ito kung saan sa pahina.)

RSS 1.0

Ang RSS 1.0 ("RDF Site Summary") ay RDF Vocabulary na nagbibigay ng lightweight multipurpose extensible metadata descripyion at syndication format. Sa maikli, ito ay paraan para mailarawan ng news at events para maibahagi sa web. Ehemplo nito ay sa praktis na kaugnay sa W3C ay mga W3C at meerkat channel, ang W3C news-is-free channel at W3C At A Glance. Sa maikli, ang RSS 1.0 ay very cool way ng paglalarawan, pag-manage at madaling maibahagi sa malawakang manonood ang relebante at timely na impormasyon

Itong dokumento ay nagbibigay ng quick guide para sa simpleng paraan ng paggawa ng RSS 1.0 news feeds mula sa W3C related domain, activity o working group home page. Ang specific goal nito ay ang epektibong integration nitong impormasyon para ibahagi sa team, member at public views ng anung nangyayari sa W3C. Rael Dornfest Writing RSS 1.0 ay nagbibigay ng mas detalyadong deskripsyon ng RSS 1.0 at mga links sa adisyonal tools at technolohiya para sa paggawa ng mga news feeds.

Itong dokumento ay ginawa para magbigay ng explanasyon ng isang paraan na nagfofocus sa paggamit ng simpleng, descriptive set ng HTML markup (tinalakay sa baba) at ng corresponding XSLT transformation file. Ito ay bumubuo kay Dan Connolly s Site Summaries in XHTML dokumento na may focus sa pagbigay ng mas simpleng, descriptive set ng HTML markup (na inilarawan sa ibaba) at ng transformation capabilities na magagamit sa malawakang kumpol ng web pages kaysa sa W3C s Home Page.

Alalahanin na sa paggamit ng documentasyong ito para sa pahina saworking group ay nangangahulugang ikaw ay maaaring tumalong sa paggamit ng working group home page markup, na, maliban sa pagpahintulot sa iyo ng mas madaliang pag-generate ng RSS feed, ay papayagan ka rin sa kaya mong data habang ikaw ay nagmamarkup na magagamit sa ibang aplikasyon.

Simpleng HTML Markup para sa Supporting RSS 1.0 generation

Kasama sa pagdagdag ng maliliit na set ng mga elements ay descriptive classes, puwede tayong semantically mag-annotate ng HTML documents para suportahan ang generasyon ng RSS 1.0 feeds. Ang susunod na ehemplo mula sa Semantic Web Home Page ay nagbibigay ng basis para sa paglarawan ng relevant feed:

    <html xmlns="http://www.w3.org/1999/xhtml">
     <head>

      <title>Semantic Web</title>
     </head>

     <body>
      <blockquote>
      <p>"<span class="summary">The Semantic Web is an extension of
      the current web in which information is given well-defined
      meaning, better enabling computers and people to work in
      cooperation.</span>" <cite>-- Tim Berners-Lee, James Hendler,
      Ora Lassila, <a
      href="http://www.scientificamerican.com/2001/0501issue/0501berners-lee.html">

      The Semantic Web</a></cite></p>
     </blockquote>

News items na ina-associate sa feed ay inilalarawan gamit ang susmusunod na mark-up:

    <h2 id="new" class="new">Events</h2>

     <ul>

      <li>

        <div class="item" id="x20020125a">
          <a class="link"

          href="http://www.w3.org/2001/sw/news#x20020125a"><img
          alt="-" width="17" height="11" src="/Icons/right" /><span
          class="title">An RDF Schema for P3P</span></a> : <span
          class="date">2002-01-25</span>, <span
          class="description">The <a
          href="http://www.w3.org/P3P/">P3P Working Group</a> has
          published An <a
          href="http://www.w3.org/TR/2002/NOTE-p3p-rdfschema-20020125">

          RDF Schema for P3P</a> as a W3C Note. Based on The <a
          href="http://www.w3.org/TR/2001/WD-P3P-20010928/">Platform
          for Privacy Preferences 1.0 (P3P1.0) Specification</a>
          Last Call Working Draft, the Note represents one possible
          RDF schema for P3P. P3P simplifies and automates the
          process of reading Web site privacy policies, promoting
          trust and confidence in the Web.</span>
        </div>
      </li>

      ...

Itong HTML ay puwedeng ma-transform sa paggamit ng XSLT file file para gumawa ng corresponding RSS news feed. Ang ehemplong nasa itaas sa RSS 1.0 ay parang ganito:

<rss:channel rdf:about="http://www.w3.org/2001/sw/Overview.rss">
  <rss:title>W3C Semantic Web</rss:title>

  <rss:link>http://www.w3.org/2001/sw/</rss:link>
  <rss:description>The Semantic Web is an extension of the current web in
  which information is given well-defined meaning, better enabling
  computers and people to work in cooperation.</rss:description>

  <rss:items>
    <rdf:Seq>

      <rdf:li rdf:resource="http://www.w3.org/2001/sw/news#x20020125a"/>
      ...
    </rdf:Seq>
  </rss:items>
</rss:channel>

<rss:item rdf:about="http://www.w3.org/2001/sw/news#x20020125a">
  <rss:title>An RDF Schema for P3P</rss:title>

  <rss:link>http://www.w3.org/2001/sw/news#x20020125a</rss:link>
  <dc:date>2002-01-25</dc:date>
  <rss:description rdf:parseType="Literal">
  <span class="description">The <a href="http://www.w3.org/P3P/"
  shape="rect">P3P Working Group</a> has published An <a
  href="http://www.w3.org/TR/2002/NOTE-p3p-rdfschema-20020125"
  shape="rect"> RDF Schema for P3P</a> as a W3C Note. Based on The <a
  href="http://www.w3.org/TR/2001/WD-P3P-20010928/"
  shape="rect">Platform for Privacy Preferences 1.0 (P3P1.0)
  Specification</a> Last Call Working Draft, the Note represents one
  possible RDF schema for P3P. P3P simplifies and automates the
  process of reading Web site privacy policies, promoting trust and
  confidence in the Web.</span></rss:description>

</rss:item>
...

Deskripsyon ng Markup

Ang susunod ay mas deskriptibong explanasyon ng associated mark-up.

Makakatulong na alam na ang RSS feed sa esensya ay sequence ng mga items, na may kaunting dagdag na collection- or feed-level information. Bawat bagay ay may titulo, ang link sa orihinal na pinaggalingan ng impormasyon ( ang news item ay tipikal na in-extract sa mas malaking kontexto), ay kaunting descriptive text.

Ang stylesheet ay gumagawa ng feed sa ganitong pamamaraan:

impormasyon tungkol sa channel. Bawat input document ay nagproprodyus ng isang RSS feed, at bagkus isang channel.
- ang channel URI (para sa rdf:about) ay pinapasa bilang parameter (ito ay hawak ng service)
- ang channel link ay pinapasa bilang parameter
- ang channel description ay concatenation ng kada span element na may class = summary
- ang channel title ay galing sa /html/head/title element sa input document
impormasyon sa mga items. Kada item sa channel ay galling sa div na may class= item sa loob ng HTML body
- o ang item s rdf:about value ay galling sa href attribute value ng a element na may class= link na lumalabas sa loob ng div (mayroon dapat isa lang; pag mas marami, di mo magugustuhan ang resulta)
- o ang item title, date, at description ay galling sa span class = xxx elements sa loob ng div, kung saan ang xxx ang title , date , o description

Lumingon ka sa kabila:

<title> (inside <head>): tang titulo ng RSS 1.0 feed
<span class = "summary">: tang deskripsyon ng RSS 1.0 feed
<div class = "item">: ang item na na-associate sa (i.e. contained in) RSS 1.0 feed
<a class = "link"> (inside an item): ang absolute URI ng enclosing item
<span class = "title"> (inside an item): ang titulo ng enclosing item
<span class = "description">: ang deskripsyon ng enclosing item. (Ikaw ay inaabisuhang gamitin ang CSS para i-specify ang font at properties tulad ng text size at color. Babawasan nito ang laki ng HTML files at gagawing mas madali ang pag-maintain kumpara sa paggamit ng FONT elements.
<span class = "date"> (sa loob ng item): ang date ng enclosing item. Ang date format para sa lahat ng W3C News Feeds ay dapat uniform, pakigamit ang YYYY-MM-DD.

Kung nag-aalangan, makakatulong konsultahin ang XSLT transformation sheet .

Nota, 2003-04-24:

Subukan!

Ang XSL file ang stylesheet na gumagawa ng scraping. Maliban kung ikaw ay nageexperimento sa variant copy nito, huwag baguhin mula sa default. Ang XML data ang XHTML page na naglalaman ng markup na sinasabi sa itaas. Ang Base ang base URI na ginagamit sa absolutizing ng relatibong URIs sa input; sa normal, ang paggawa nito ay katulad sa XML data na tamang paraan. Ang Channel ang URI kung saan ang output RSS ay dapat pumunta. Ang Page ang URI kung saan ang RSS channel ay kokonekta. (Kung nag-aalangan, gawing pareho ito sa XML data.)

Pag masaya ka na sa resulta, itong serbisyo ay puwedeng i-automated sa CVS-commit triggered scripting. Iyan ay, pag gumawa ka na ng pagbabago sa XHTML file at mag-commit ito sa aming CVS space, ang XSLT ay puwedeng tumakbo rito at ang RSS file na na-generate kaagad at mabilis. Sa ngayon, pakikontak si Ryan Lee (ryanlee@w3.org) para makuha ang iyong feed set up.

Pag nakalagay na ito at gumagana sa iyong kagustuhan, ipaalam na lang sa me, at aming configure ang W3C At A Glance para masama sa bagong kontent .

Dagdag Reperensya

Para Makita ang ibang ehemplo, o para sa mas maraming impormasyon:

W3C at a glance. Top-level overview ng mga news feeds na ngayon ay gawa gamit nitong systema.
Sample news feed para sa single Activity, galing sa the DOM Activity public home page, na puwedeng ikonsulta para magamit sa contexto ng HTML markup na sinasabi sa itaas. Ang RSS form ng impormasyon para sa Activity ay maaari ring makita.
[Dominique Hazaël-Massieux], W3C Organization HTML Profile, 21 January 2003. Ang deskripsyon ng markup used gamit ang similar na HTML-scraping tool para sa pag-extrak ng impormasyon tungkol sa W3C activities at grupo.
Rael Dornfest, Writing RSS 1.0. O Reilly Network, 25 August 2000.
Ryan Lee, Working Group Home Page Markup Guidelines.
RSS-DEV Working Group, RDF Site Summary (RSS) 1.0. Heneral na impormasyon at links.
Dan Connolly, Site Summaries in XHTML. August 2000, huling rebisyon May 2001.