W3C home > Mailing lists > Public > w3c-wai-ua@w3.org > April to June 2007

Re: UAWG Wiki update

From: Peter Parente <pparent@us.ibm.com>
Date: Tue, 19 Jun 2007 16:06:59 -0400
To: Jan Richards <jan.richards@utoronto.ca>
Cc: WAI-UA list <w3c-wai-ua@w3.org>
Message-ID: <OFDE7E323B.9B38A145-ON852572FF.006E327F-852572FF.006E809F@us.ibm.com>
No problem. Just an idea.

You can style the HTML output from rst using CSS. But if you're looking for
an authoring tool that does all of that for you, rst isn't what you want.

Pete



Peter Parente
pparent@us.ibm.com
Tie: 526-2346
IBM: 919-486-2346


                                                                           
             Jan Richards                                                  
             <jan.richards@uto                                             
             ronto.ca>                                                  To 
                                       Peter Parente/Raleigh/IBM@IBMUS     
             06/19/2007 03:06                                           cc 
             PM                        WAI-UA list <w3c-wai-ua@w3.org>     
                                                                   Subject 
                                       Re: UAWG Wiki update                
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           




Hi Peter,

Thanks for the suggestion.

I'm not sure about RST. It seems like a lot of work up front and I'm not
sure it can handle all the styling etc. that the document (even Editor's
drafts) need.

But maybe this is something we can discuss on Thursday.

Cheers,
Jan



Peter Parente wrote:
> Hi Jan,
>
> Thanks for setting up the wiki. One suggestion: MoinMoin wiki markup is
> pretty darn ugly. However, MoinMoin does supported reStructuredText (rst)

> format which is designed to be readable even as plain text. It also has
> the bonus of being renderable to (X)HTML (standards compliant), DocBook,
> LaTeX (and hence PDF, PS, etc.), S5, and more, possibly cutting down on
> the amount of editing you need to do when going from the wiki to HTML. (I

> can show you how to render the rst wiki pages into a single, standalone,
> styleable HTML document when the time comes if you'd like.)
>
> Would it be possible to get rst configured on the wiki server? There are
> instructions for doing it on the wiki already at
> http://www.w3.org/WAI/UA/wiki/HelpOnParsers/ReStructuredText and a primer

> on the format at
> http://www.w3.org/WAI/UA/wiki/HelpOnParsers/ReStructuredText/RstPrimer
> (which won't render until you have rst installed of course).
>
> The main rst and docutils (which does the rendering) website is at
> http://docutils.sourceforge.net/rst.html.
>
> Just an idea,
> Pete
>
> Peter Parente
> IBM Linux Accessibility Project
> pparent@us.ibm.com
> Tie: 526-2346
> UNC: 919-962-1780
> IBM: 919-486-2346
>
>
>
> Jan Richards <jan.richards@utoronto.ca>
> Sent by: w3c-wai-ua-request@w3.org
> 06/15/2007 01:55 PM
>
> To
> WAI-UA list <w3c-wai-ua@w3.org>
> cc
>
> Subject
> UAWG Wiki update
>
>
>
>
>
>
>
> Hi everyone,
>
> The UAAG wiki is up and I'm STARTING to add the UAAG text. To get signed
> up go to:
>
> http://www.w3.org/WAI/UA/wiki/FrontPage
>
> And then create an account. Usually accounts are FirstnameLastname (e.g.
> JanRichards).
>
> Once you have an account name, please email it to me so I can sign you
> up to have edit privileges.
>
> I've been thinking about the best way to use the wiki...since there
> needs to a balance between several factors:
>
> 1. Don't want pages to be too big.
> 2. Don't want too many pages since it makes compiling them into an
> Editor's draft too difficult.
> 3. The wiki loses formatting so I don't want the WHOLE document to be on
> the wiki - since then I will have to reformat the whole thing for each
> Editor's draft.
>
> So here's what I'm thinking...
>
> We have a main TOC page (http://www.w3.org/WAI/UA/wiki/UaagDocument) and
> make wiki pages for each Checkpoint (1.1,1.2, etc.). That way we can
> play with the organization on the main page and update the checklist
> wordings on the individual pages.
>
> Alternatively we could have a wiki page for the group of checkpoints
> under each guideline.
>
> If you have any other thoughts please let me know.
>
> Cheers,
> Jan
>
>
>

--
Jan Richards, M.Sc.
User Interface Design Specialist
Adaptive Technology Resource Centre (ATRC)
Faculty of Information Studies
University of Toronto

   Email: jan.richards@utoronto.ca
   Web:   http://jan.atrc.utoronto.ca
   Phone: 416-946-7060
   Fax:   416-971-2896







pic32379.gif
(image/gif attachment: pic32379.gif)

Received on Tuesday, 19 June 2007 20:07:18 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 14:49:35 UTC