On Thu, 10 Jul 2008 15:03:55 -0400, ingo wrote:

> in news:48753b6f@news.povray.org Jim Henderson wrote:
> 
>> Even still, the challenge remains of getting the data both in and out
>> of the wiki for publication in the various formats.
> 
> either I was not clear or you misunderstood, I only want to convert from
> the current doc format to the wiki, not back. The editor can copy past
> the suggestions from the wiki into the orginal documentation, edit it if
> needed and add the tags needed for the povdoc format. Even if there is a
> simple wiki>povdoc conversion, an editor will have to go through the
> whole thing anyway to ad tags like the <indexentry>

The goal is to make the job easier for the editor as well. :-)

> I don't see this documentation maintained by the community without a
> responsible editor and editing is a hands on job. 've done it quite a
> few years ;)

As have I, along with having written a couple of books along the way. :-)

The way it's done IME in the publishing world is that there's a template 
that provides instructions to typesetting equipment - so, for example, a 
particular style would say "this is a tip" and defines in the typesetting 
how the information should look.

From the standpoint of maintaining the doc, something similar would make 
sense here.  The intent would be that not everyone could edit, but to 
make the transition back to the markup used by the POV team means less 
chance of content confusion, misplaced headers, and things like that.

The more automation there is, the better, since everyone here is a 
volunteer.  :-)

Jim

Post a reply to this message