W3C home > Mailing lists > Public > public-webplatform@w3.org > December 2012

Re: [templates] Listing pages

From: Alex Komoroske <komoroske@google.com>
Date: Thu, 6 Dec 2012 16:03:01 +1100
Message-ID: <CAPwaZpUGg5_xsE8gYH4gRe4byEw_T5sEY4+xJDScp1v3joUn3w@mail.gmail.com>
To: Scott Rowe <scottrowe@google.com>
Cc: "public-webplatform@w3.org" <public-webplatform@w3.org>
On Thu, Dec 6, 2012 at 12:56 PM, Scott Rowe <scottrowe@google.com> wrote:

> Thanks Alex,
> To the exception, lemme 'splain, below...
>
>
> On Wed, Dec 5, 2012 at 4:39 PM, Alex Komoroske <komoroske@google.com>wrote:
>>
>>
>>>
>>> Following the Main Content, the page would display a listing table of
>>> Objects using the same mechanism that the API_Object page uses to pull
>>> together tables of Properties, Methods, and Events - with the "Applies to"
>>> field of those pages. This Object/Summary table could replace the
>>> query-based or sub page-based table, or we could allow for that table to
>>> appear at the end of the page (which would require moving it down in the
>>> form).
>>>
>>
>> I don't think this is a good idea. The Applies_to machinery is very
>> specifically suited to members of an interface, where each member is part
>> of one interface. The API_Listing pages allow more rich queries that permit
>> you to have a single leaf page easily show up in multiple category listings
>> without the leaf page having to know anything about where else it's being
>> included.
>>
>
>>> The tables generated in the listing pages currently are category based,
> which means that even if I leave "print all subpages" unchecked, I still
> get the members of the objects in the table, when I only want the objects.
> You can see that in the apis/webrtc<http://docs.webplatform.org/wiki/apis/webrtc>page.
>
> What I'm trying to do here is generate a list of just the objects in the
> API, not all the subpages. I was suggesting the technique used with the
> "Applies to" field, but if there is a better way, that's fine.
>
> The idea is to summarize each API object in an API listing, with links to
> the objects, so that users don't have to wade through a long table of
> members.
>
>
Ah, I think I understand you now. What you want to do is modify your query
to select only pages that are in the right category AND are in the
API_Objects category. In that specific example, I believe it would be
something like "[[Category:WebRTC]][[Category:API_Listings]]". This page:
http://semantic-mediawiki.org/wiki/Help:Selecting_pages has more
information on the types of queries you can construct.

Does that adress your suggestion?
Received on Thursday, 6 December 2012 05:04:48 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:57:36 UTC