operating-hours: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(reformat/ rework page)
(needs merging into opening-hours)
(13 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<h1>Operating Hours</h1>
<entry-title>Operating Hours</entry-title>


This page documents an effort to determine a simple, open, and semantic format for marking up the operating hours of stores, restaurants, museums, offices, and other estabishments that have set hours and are open on a regular basis. This is based on the [[hCalendar]] microformat.
'''This and related pages needs to be merged into the more aptly (and OSM-prior art) named "[[opening-hours]]" page(s).''' - [[User:Tantek|Tantek]] 20:16, 29 December 2012 (UTC)


__TOC__
This is an effort to figure out how to best markup the operating hours (workhours, hours open, etc.) of venues (stores, restaurants, museums, offices, and other establishments) that have set hours and are open on a regular basis.
== Discussion participants ==


=== Editor ===
Per the [[process]]
* [http://dragotown.com Nick Drago]
* [[operating-hours-examples]]
* [[operating-hours-formats]]
* [[operating-hours-brainstorming]]
 
= Operating Hours Brainstorming =
'''This should be moved to [[operating-hours-brainstorming]].'''
 
This section documents a method that can be used to mark up the operating hours of stores, restaurants, museums, offices, and other establishments that have set hours and are open on a regular basis. This is based on the [[hCalendar]] microformat.


== Discussion Participants ==
=== Authors ===
=== Authors ===
* [http://dragotown.com Nick Drago]
* [http://dragotown.com Nick Drago]
* [http://suda.co.uk/ Brian Suda]


=== Contributors ===
=== Contributors ===
* [http://suda.co.uk Brian Suda]
* Add your name if you feel you have made significant additions to the page.


== Introduction ==
== Introduction ==
This effort came about as a result of the need for a human and machine readable markup format that can be used to define the operating hours of establishments.
This effort came about as a result of the need for a human and machine readable markup format that can be used to define the operating hours of establishments.


Stores, businesses, etc. often provide their operating hours on their websites. With the addition of a small bit of markup, they would be able to discuss their operating hours on their websites in such a way that spiders and other aggregators can retrieve such hours, automatically convert them to the iCalendar format, and use this data in any iCalendar application or service.
Stores, businesses, etc. often provide their operating hours on their websites. With the addition of a small bit of markup, they are able to define their operating hours on their websites in such a way that spiders and other aggregators can retrieve such hours, automatically convert them to the iCalendar format, and use this data in any iCalendar application or service.


This document proposes the introduction of a format which is a close subset of the [[hCalendar]] microformat, and thus the iCalendar standard, in semantic XHTML. Organizations and businesses can both embed their operating hours directly in their web pages and style them with CSS to make them appear as desired. In addition, this format would enable applications to retrieve such data directly from web pages without having to reference a separate file.
== Using RRULE in hCalendar ==
This was suggested [http://microformats.org/discuss/mail/microformats-discuss/2007-February/008562.html] by Brian. Is this the most appropriate method? --Nick


== Brainstorming ==
<pre>
There are several main components to this listing:
// example definition of operating hours using RRULE in hCalendar
* Location
** The establishment name
** The establishment address
* Hours
** Day of week
** Open time
** Close time


== Using RRULE in hCalendar ==
''This section needs revision.''
<pre>
<h1>Pardon the Interruption</h1>
<h1>Pardon the Interruption</h1>
<p class="vevent">
<p class="vevent">
Line 78: Line 75:
* [http://www.xfront.com/microformats/hCalendar_part2.html Tutorial on recurring events in hCalendar]
* [http://www.xfront.com/microformats/hCalendar_part2.html Tutorial on recurring events in hCalendar]


=== Related pages ===
=== Related ===
* [[operating-hours-examples]]
* [[operating-hours-examples]]
* [http://microformats.org/discuss/mail/microformats-discuss/2007-February/008562.html Corresponding thread from uf-discuss]

Revision as of 20:16, 29 December 2012

<entry-title>Operating Hours</entry-title>

This and related pages needs to be merged into the more aptly (and OSM-prior art) named "opening-hours" page(s). - Tantek 20:16, 29 December 2012 (UTC)

This is an effort to figure out how to best markup the operating hours (workhours, hours open, etc.) of venues (stores, restaurants, museums, offices, and other establishments) that have set hours and are open on a regular basis.

Per the process

Operating Hours Brainstorming

This should be moved to operating-hours-brainstorming.

This section documents a method that can be used to mark up the operating hours of stores, restaurants, museums, offices, and other establishments that have set hours and are open on a regular basis. This is based on the hCalendar microformat.

Discussion Participants

Authors

Contributors

Introduction

This effort came about as a result of the need for a human and machine readable markup format that can be used to define the operating hours of establishments.

Stores, businesses, etc. often provide their operating hours on their websites. With the addition of a small bit of markup, they are able to define their operating hours on their websites in such a way that spiders and other aggregators can retrieve such hours, automatically convert them to the iCalendar format, and use this data in any iCalendar application or service.

Using RRULE in hCalendar

This was suggested [1] by Brian. Is this the most appropriate method? --Nick

// example definition of operating hours using RRULE in hCalendar

<h1>Pardon the Interruption</h1>
<p class="vevent">
  <a class="url uid summary"
href="http://sports.espn.go.com/...">Pardon the Interruption</a>
  is a <span class="category">TV</span> <span
class="category">sports</span> show.
  <abbr class="dtstart" title="2001-10-22">It airs</abbr>
  <span class="rrule">
        <span class="freq">weekly</span>
    <abbr class="byday" title="mo,tu,we,th,fr">Monday to
Friday</abbr> at <abbr class="byhour" title="5">5:30pm</abbr>
  </span>

  <!-- timezones should be avoided -->
  <abbr class="tzid" title="US-Eastern">ET</abbr> on ESPN.

  The hosts of the show are longtime friends
  <span class="hcard">
      <span class="fn n">
          <span class="given-name">Tony</span>
          <span class="family-name">Kornheiser</span>
      </span>
  </span>
  and ... (hCard for Michael Wilbon not shown)
  <span class="description">They discuss - and frequently argue over
- the top stories of the
  day in "sports... and other stuff".</span>
</p>

References

Normative References

Informative References

Related