W3C home > Mailing lists > Public > public-sysapps@w3.org > October 2012

Re: WebIDL to Anolis source?

From: Glenn Adams <glenn@skynav.com>
Date: Fri, 26 Oct 2012 17:42:41 +0200
Message-ID: <CACQ=j+cXOK+7-Ka0wy-o=5Kit5CjGfh6kUyepmMWGB_k3t_jVQ@mail.gmail.com>
To: "Kis, Zoltan" <zoltan.kis@intel.com>
Cc: Adam Barth <w3c@adambarth.com>, Wonsuk Lee <wonsuk11.lee@samsung.com>, public-sysapps@w3.org
On Thu, Oct 25, 2012 at 2:52 PM, Kis, Zoltan <zoltan.kis@intel.com> wrote:

> Hello,
>
> Sorry to bother you with a productivity issue.
>
> In [1] Anolis is recommended for generating the specifications from a
> raw .src.html file.
> This would be fine, but one important step is missing: from me to the
> Anolis source. It is extremely inconvenient to write the Anolis
> src.html files in text editor. It is a total aberration and a crime
> against human eyes to write specifications like this, it's unreadable
> and needs many times more time to write, or find and correct
> something. For younger eyes this may be OK, but for me it's
> unbearable. Using ReSpec is better, but not by much.
>
> I would like to write WebIDL code with Doxygen-like comments and
> annotations, and would need a tool for generating the Anolis src.html
> from this. These are equivalent information.
>
> I think it would be possible to do this with widlproc (by generating
> XML out of WebIDL by widlproc and then HTML from XML by xsltproc,
> based on a HTML template). We used to use this for generating the
> Tizen Web API specifications, and worked fine. We'd need a template
> for W3C/Anolis, and it should work in a similar way.
>
> Does anyone have a better solution to this problem?
> I can't believe everyone is writing source text for Anolis/W3C, so
> likely there is (?) a solution.
>

I had a similar issue with using Anolis for the CSSOM spec. What I ended up
doing was using WebIDL as the source, along with use of [Documentation]
extended attributes. I wrote a small pre-processor that uses Robin's
webidl.js and html5.js running in node.js to accomplish this. While this
pre-processor is neither complete nor documented, it is one possible
approach you might consider, and feel free to use code under [1] (see
README) if you wish.

[1] https://dvcs.w3.org/hg/csswg/file/tip/cssom
Received on Friday, 26 October 2012 15:43:31 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 26 October 2012 15:43:31 GMT