W3C home > Mailing lists > Public > public-html@w3.org > August 2009

Re: author view of HTML 5 spec - static copy (2nd try)

From: Dan Connolly <connolly@w3.org>
Date: Thu, 27 Aug 2009 09:54:45 -0500
To: Ian Hickson <ian@hixie.ch>
Cc: public-html@w3.org
Message-Id: <1251384885.22683.55.camel@pav.lan>
On Wed, 2009-08-26 at 18:26 +0000, Ian Hickson wrote:
> On Wed, 26 Aug 2009, Dan Connolly wrote:
> > 
> > I don't think we've managed to make it available in the w3.org versions 
> > to date, plus it takes some heavy CSS lifting in the browser.
> 
> I think the W3C versions have it; it's just an alternative style sheet, 
> which can be accessed through your browser's UI.

Oh; maybe I just didn't notice.

> > So thanks to Geoffrey and James and company, I learned a little bit 
> > about the build tools and made a static copy:
> > 
> > multipage version:
> > http://dev.w3.org/html5/spec-author-view/multipage/Overview.html
> > 
> > single page version:
> > http://dev.w3.org/html5/spec-author-view/multipage/spec.html
> 
> The section numbers seem to be different here than in the full spec; while 
> I can see that the section numbers being consecutive makes some sense, I 
> think that having them differ from other views of the spec is going to 
> make feedback very confusing.

Yes. Ouch.

>  Is there any chance we can keep the numbers 
> in sync between the two copies?

The easiest thing I can think of is: for each section that
gets filtered out, keep a stub that's just a heading
and some sort of note a la "for details, see the full spec".

I'm not sure how much work it is to do that... so far
all I've done is play with command line args on anolis
and spec-splitter.py . (Well, I did embellish the
spec-splitter diagnostics a little, but I didn't even
bother to commit that patch anywhere.)

> Is there a flag I can pass to the anolis on pimpmyspec.net to autogenerate 
> this copy,

A lot of the work is done with a --filter=.impl flag on anolis.

Again, to see how I generated this copy, see:
  http://dev.w3.org/html5/spec-author-view/Makefile

>  or should it be added to Mike's post-cvs-checkin stuff like the 
> current spec splitter?

Mike did offer to do that.

-- 
Dan Connolly, W3C http://www.w3.org/People/Connolly/
gpg D3C2 887B 0F92 6005 C541  0875 0F91 96DE 6E52 C29E
Received on Thursday, 27 August 2009 14:59:19 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 9 May 2012 00:16:44 GMT