********************** ***** HISTORY ***** ********************** 2009-12-17: Fixed a typo on the dateModified element. Was missing the second letter 'i' *************************************************** ***** COMPLEX TYPES (alpha order) ***** *************************************************** bodyType - is the main content of an OPML document headType - provides title, date and window information outlineType - is a tree of distinct content pieces to be organized in outliner applications outlineWithTypeType - allows for building on the base OPML outline tag with type having a controlled vocabulary and allows type to be extended or restricted separately from other outline attributes type - indicator of how the attributes on the outline element are to be interpreted bodyType - contains one or more outline elements outline - the contents to be displayed; may contain encoded HMTL markup; see outlineType headType - contains zero or more of the optional elements defined below title - title or name of the document dateCreated - a date-time indicating when the document is created; conforms to RFC 822 (http://asg.web.cmu.edu/rfc/rfc822.html); see the Simple Types section for more information dateModified - a date-time indicating when the document has last modified; conforms to RFC 822 (http://asg.web.cmu.edu/rfc/rfc822.html); see the Simple Types section for more information ownerName - the owner of the document ownerEmail - the email address of the owner of the document; see the Simple Types section for more information ownerId - an http address of a web page that contains a form that allows a human reader to communicate with the author of the document via email or other means docs - an http address of documentation for the format used in the OPML file expansionState - a comma separated list of line numbers that are expanded. The line numbers indicate which headlines to expand. Order is important. For each element in the list, X, starting at the first summit , navigate flatdown X times and expand. Repeat for each element in the list. vertScrollState - is a number indicating which line of the outline is displayed on the top line of the window. This number is calculated with the expansion state already applied. windowTop - is a number indicating the pixel location of the top edge of the window windowLeft - is a number indicating the pixel location of the left edge of the window windowBottom - is a number indicating the pixel location of bottom top edge of the window windowRight - is a number indicating the pixel location of the right edge of the window text - the content to be displayed to users isComment - indicates whether the outline is commented or not; by convention if an outline is commented, then all subordinate outlines are considered commented isBreakpoint - indicates whether a breakpoint is set on this outline created - generation date-time of the outline node category - comma-separated, slash-delimited sets of strings description - the top-level description element from a feed url - an http address to display in a browser or a pointer an OPML file htmlUrl - the top-level link element from a feed; that is a feed attribute that tells a reader where the HTML version of the feed exists xmlUrl - the http address of the feed in XML title - the top-level title element from a feed version - the type of feed (e.g. RSS2, RSS1, etc.) language - the top-level language element from a feed outlineWithTypeType - allows for building on the base OPML outline tag with type having a controlled vocabulary and allows type to be extended or restricted separately from other outline attributes outline - the contents to be displayed; may contain encoded HMTL markup typeAttribute - defines the contents of the type attribute ************************************************ ***** SIMPLE TYPES (alpha order) ***** ************************************************ rfc822Type - defines a date-time format of the form Mon, 00 Jan 0000 00:00:00 +0000 tEmailAddress - defines an email address of the form person@some.org typeType - a list of terms that are acceptable values for the attribute type on the outline element union.languageType - allows the term unknown to be used with the built-in W3C language type of 2-letter language identifiers union.typeType - concatenates together free text string and a list of acceptable type values unknownType - defines the term called unknown that is used in the union.languageType versionType - defines the version numbers for existing OPML specifications Got from http://www.thearchitect.co.uk/schemas/rss-2_0.xsd and it is called tRfc822FormatDate; The notes from this rss-2_0.xsd schema are copied below A date-time displayed in RFC-822 format. Using the regexp definition of rfc-822 date by Sam Ruby at http://www.intertwingly.net/blog/1360.html Using the regexp definiton of E-Mail Address by Lucadean from the .NET RegExp Pattern Repository at http://www.3leaf.com/default/NetRegExpRepository.aspx ********************************** ***** SCHEMA PUPOSE ***** ********************************** Define base OPML 2.0 elements and attributes OPML stands for Outline Processor Markup Language and is used for exchanging information between outliners and Internet services. It is intended to be the file format for outliner applications. It can also be used to exchange subscription lists between feed readers and aggregators. ******************************* *****SCHEMA INTENT ***** ******************************* Intended to be called by an overarching schema that creates an OPML 2.0 document The overarching schema defines the root element called opml ****************************** ***** NAMESPACES ***** ****************************** No extra namespaces are used in this schema The W3C schema is in the xs namespace The overarching schema used to create the OPML document may use a namespace ******************************** ***** ROOT ELEMENT ***** ******************************** This schema does not contain a root element The overarching schema needs to define the root element and call this schema to create OPML ******************************************* ***** SCHEMA DEVELOPMENT ***** ******************************************* Tends to follow the Venetian Blind approach that defines types that can be extended Interprets the OPML 2.0 specification by Dave Winer found at: http://www.opml.org/spec2 Created: 2006-04-20 Last Modified 2009-12-17 ********************************** ***** SCHEMA AUTHOR ***** ********************************** Katy Ginger, University Corporation for Atmospheric Research (UCAR), Digital Library for Earth System Education (DLESE) Program Center; email: support@dlese.org or ginger@ucar.edu ****************************************** ***** LICENSE INFORMATION ***** ****************************************** Copyright (c) 2006 University Corporation for Atmospheric Research (UCAR) P.O. Box 3000, Boulder, CO 80307, United States of America This schema is free software; you can redistribute them and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. These schemas are distributed in the hope that they will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this project; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA ****************************************************** ***** OTHER COPYRIGHT INFORMATION ***** ****************************************************** Parts of this page are copied and developed from Dave Winer's OPML specification found at: http://www.opml.org/spec2. Per the request of that document, its copyright notice is included here and applies to information in this directory and corresponding subdirectories: © Copyright 2000 UserLand Software, Inc. All Rights Reserved. © Copyright 2006 Scripting News, Inc. All Rights Reserved. UserLand Software, Inc. and Scripting News, Inc. are refererred to in the following as "the Companies." This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and these paragraphs are included on all such copies and derivative works. This document may not be modified in any way, such as by removing the copyright notice or references to the Companies or other organizations. Further, while these copyright restrictions apply to the written OPML specification, no claim of ownership is made by the Companies to the format it describes. Any party may, for commercial or non-commercial purposes, implement this format without royalty or license fee to the Companies. The limited permissions granted herein are perpetual and will not be revoked by the Companies or their successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE COMPANIES DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.