Re: format for the documentation

>
>Hello Alex, hello group,
>
>Here is the "How to Create your first publication with Wyona"! 
>Please see the attached file howto-helloworld.zip. See the 
>documentation online: 
>http://www.target-x.com/wyona-cms/howto/howto-helloworld.html. 
>Please read the readme.txt find in the *.zip file.

Hi Thorsten, hi list,

your output looks promising, indeed. I already sent you my first 
comments separatly. Other things I saw, as I took a look at the 
document mentioned above

- spilt the document and the sitemap in different parts. It's better
   to take small steps, than to puit an overload on the users mind....
   My idea:
     step 1: - create the html-document
                - create the sitemap
                - test step 1

     step 2: - create the xml-document
                - create the xsl-document
                - update the sitemap
                - test step 2

     step 3: - create the xsl-document
                - update the sitemap
                - test step 3

- actually there isn't much of wyona's capabilities involved (that's 
intended!) except
    for step 5 of your how-to. Therefore I would stress out, that these how-tos
    are a good starting point to get a feeling of working with cocoon 
(which is also
    used as publishing framework by wyona)

>I tried to do it in a apache way ;-). I found within cocoon 
>documentation "How to Publish XML Documents in HTML and PDF"
>written by Bertrand Delacrètaz.
>
>I used the document-v10.dtd. And used document2html.xsl. But have a 
>look! I can use your help on finding all errors!? Is it forrest 
>conform?

did you take a look at <http://xml.apache.org/forrest/dtd-docs.html>?

There is a DTD for howto 
<http://xml.apache.org/forrest/howto-v10.dtdx.html> (still envolving) 
on the other hand the DTD you used is outdated. (see 
<http://xml.apache.org/forrest/document-v11.dtdx.html>); your's seams 
the same like the one already used by wyona, however the newer one 
brings some nice changes. An example:

from:
...
   <s1 title="Some Title">
     <p>A paragraph.....</p>
     </s1>

to:
...
   <section>
     <title>Some Title</title>
        <p>A paragraph....</p>
   </section>
...

No big changes, but usefull ones...


>What I would like to do is to modified this howto to a publication 
>where I can add a howto to the pub and afterwards edit it with Xopus 
>(Bitflux is not runnig :-(). This pub should be Forrest conform! It 
>should copy a empty document (doctype: howto-) and should be then 
>editable with Xopus.

This is a great idea. Ideally the editable files would reside on the 
wyona-server. I wanted to figure  out what it takes to be able to 
publish the wyona files trough the forrest-func an to keep the look & 
feel of wyona. Unfortunatly, time flew too fast, and lot of other 
things happend within the last days. I keep you posted about the 
results.

Markus

>e.g. I can add more steps and paste source code to the source 
>elements. Any Help and Ideas appreciated!
>
>The weekend is finished and I haven't read a message from Markus (so 
>some bad beginners line are still in there!) I will try to fix them 
>all with end of the week (paying job: due tuesday).
>
>King regards
>Thorsten Scherler
>
>
>Alex McLintock wrote:
>>At 00:35 08/11/02, Markus Vaterlaus wrote:
>>
>>>Wyona uses for all of its own documents a special kind of 
>>>xdoc-format. xdoc is also used by cocoon and comes from the 
>>>forrest project <http://xml.apache.org/forrest>.
>>
>>
>>
>>I strongly agree with doing things "the apache way" unless there is 
>>a really good reason not to.
>>
>>
>>PS Sorry I haven't helped out much with the example Wyona 
>>application - I am still interested in helping with it. However I 
>>have been concentrating on finding more paying work...
>>
>>Alex
>>
>>
>>
>>Openweb Analysts Ltd, London.
>>Software For Complex Websites http://www.OWAL.co.uk/
>>Open Source Software Companies please register here 
>>http://www.OWAL.co.uk/oss_support/
>>
>>
>>_______________________________________________
>>WyonaCMS-users mailing list
>>[email protected]
>>http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-users
>>
>
>
>Attachment converted: Macintosh HD:howto-helloworld.zip (pZIP/pZIP) (0007E859)


-- 
**************************************

Unglaublich, aber wahr: Dilbert lebt!

**************************************