W3C home > Mailing lists > Public > public-rdf-dawg@w3.org > October to December 2009

Re: Editing documents

From: Lee Feigenbaum <lee@thefigtrees.net>
Date: Mon, 19 Oct 2009 08:04:22 -0400
Message-ID: <4ADC55C6.6050603@thefigtrees.net>
To: "Seaborne, Andy" <andy.seaborne@hp.com>
CC: Birte Glimm <birte.glimm@comlab.ox.ac.uk>, SPARQL Working Group <public-rdf-dawg@w3.org>
Seaborne, Andy wrote:
> What about considering the publishing process that OWL used (as well as xmlspec) ?  Didn't they just use the wiki for editing? 

Every time the subject's been brought up with Sandro, we've sort of been 
warned off by it being pretty complicated, and probably not worth it 
unless all documents were going to go that route. That said, if someone 
else wanted to investigate further...

> It would not work for me for the SPARQL Query doc because there is existing content but for the property path content, the primary version is in the wiki.  I think the OWL wiki has a number of extensions added that aren't present in the SPARQL one; I came across __NUMBEREDHEADINGS__ but didn't look for an exhaustive list.
> 
> I guess it depends on the number of documents that might be authored on the wiki and what it takes to set up.

Yeah, exactly this.

Lee

> 	Andy
> 
>> -----Original Message-----
>> From: public-rdf-dawg-request@w3.org [mailto:public-rdf-dawg-request@w3.org]
>> On Behalf Of Birte Glimm
>> Sent: 14 October 2009 16:00
>> To: SPARQL Working Group
>> Subject: Editing documents
>>
>> Hi all,
>> I manually converted my wiki page for entailment regimes into an xml
>> page in the CVS repository, but I got the impression that we seem to
>> be using different methodologies. Lee said that from the xml page a
>> static HTML page will be generated, but most editors seem to be
>> working directly on their html file and do not use the xml file, so
>> what are we supposed to use? We should have a somehow uniform process
>> for editing the documents.
>> The xml uses an xsl file to render in the browser and the style
>> information are mainly there, but we have several copies of the xsl
>> file and it is quite specific to the xml spec from which I assume this
>> file was originally copied. In the xml file you can only use commands
>> that are defined in the xsl file, e.g., I can write
>> <rfc2119>MAY</rfc2119> to get a bold MAY, but I cannot write
>> <b>MAY</b>, which uses normal HTML commands as the wiki does. If we
>> want to use the xml/xsl files, we should have one central file and
>> adapt it to he SPARQL needs and all use that I would think. If we want
>> to use HTML, we should still use a consistent style and then I would
>> have to know which css file I should use.
>> Cheers,
>> Birte
>>
>> --
>> Dr. Birte Glimm, Room 306
>> Computing Laboratory
>> Parks Road
>> Oxford
>> OX1 3QD
>> United Kingdom
>> +44 (0)1865 283529
> 
Received on Monday, 19 October 2009 12:05:00 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 16:15:40 GMT