Re: format for the documentation

Hello Markus, hello group,

Markus Vaterlaus wrote:

> your output looks promising, indeed. 
Thank you very much!

> - 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
> 
I tought so as well, but now I think:
then it is not a how to anymore. but then it is a tutorial.

But right, I promised a tutorial ;-) (but it will take some time, have 
to work and write my thesis). Have a look: 
http://xml.apache.org/cocoon/howto/xmlform-wizard/howto-xmlform-wizard.html

I would like to have this fashion.

> - 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 think so as well: you will never understand wyona unless you know 
cocoon (at the moment)

> to:
> ...
>   <section>
>     <title>Some Title</title>
>        <p>A paragraph....</p>
>   </section>
> ...
> 
> No big changes, but usefull ones...
> 
I will fix that as well (SPEAKING I will use the forrest dtd!)

> 
>> 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.
> 

Lets work on that together. I started this pub for the exsample 
publication (WE SPEAK ABOUT IT BEFORE). So everybody is invited to 
develop it.

I think Alex will have some ideas on that as well!

> 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)
> 
> 
>