UserPreferences

UseElementsForAppCollectionTitles2


Abstract

Like UseElementsForAppCollectionTitles, but using atom:title. Also, require atom:id on collections.

Status

Proposed

Rationale

Same rationale as UseElementsForAppCollectionTitles. However, if we move from a title attribute to one or more title elements (which may be language sensitive), it's helpful to havfe an alternative way of distinctly identifying collections. Having the atom:id of the collection feed in the collection element is cheap and easy.

Proposal

7.1 Example

  <?xml version="1.0" encoding='utf-8'?>
  <service xmlns="http://purl.org/atom/app#">
    <workspace> 
      <atom:title>Main Site</atom:title>
      <atom:id>tag:example.org,2006:/mainsite</atom:id>
      <collection href="http://example.org/reilly/main">
        <atom:title>My Blog Entries</atom:title>
        <atom:id>tag:example.org,2006:/reilly/main</atom:id>
      </collection>
      <collection href="http://example.org/reilly/pic" >
        <atom:title>Pictures</atom:title>
        <atom:id>tag:example.org,2006:/reilly/pic</atom:id>
        <accept>image/*</accept>
      </collection>
    </workspace>
    <workspace>
      <atom:title>Side Bar Blog</atom:title>
      <atom:id>tag:example.org,2006:/sidebar</atom:id>
      <collection href="http://example.org/reilly/list">
        <atom:title>Remaindered Links</atom:title>
        <atom:id>tag:example.org,2006:/reilly/list</atom:id>
      </collection>
    </workspace>
  </service>
  
7.2.2 The "app:workspace" Element

...
  appWorkspace =
     element app:workspace {
        appCommonAttributes,
        attribute title { text },
        ( atomTitle+
          & appCollection+
          & extensionElement* )
     }
     
7.2.2.1 The "atom:title" Element

The app:workspace Element MUST contain one or more "atom:title" elements
giving a human-readable title for the workspace.

7.2.3 The "app:collection" Element

...
  appCollection =
    element app:collection {
      appCommonAttributes,
      attribute href { atomUri },
      ( atomId
        & atomTitle+
        & appAccept?
        & extensionElement* )
    }

7.2.3.1 The "atom:id" Element

The app:collection Element MUST contain one atom:id specifying the atom:id 
of the collection's Feed Document.

7.2.3.2 The "atom:title" Element

The app:collection Element MUST contain one or more "atom:title" elements
giving a human readable title for the collection.

Impacts

Notes


CategoryProposals