format for the documentation [was: [Wyonacms-users] Re: Creating new pages with wyona - Getting organised]

Hello Thorsten, hi list,

a small step for the list, a big one for mankind! Here we go... The 
next step is the bigger one: Putting it all together in a tutorial. 
If you need any help, let me know.

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 suggest for writing the 
documentation, using the original formats proposed by forrest a the 
way to go (allthough there are some minor changes to be taken on the 
wyona site). You'll find the according dtd's here: 
<http://xml.apache.org/forrest/dtd-docs.html>. A nice example showing 
a lot of  possibilities is found here: 
<http://xml.apache.org/forrest/document-v11.html>

I' even dare to think of an idea to use forrest and such things like 
<http://xml.apache.org/forrest/your-project.html#N10298> to publish 
wyona's own documents. Especially, as I like a lot of the small nifty 
gadgets, that forrest offers (ex. the tabs). Though, I'll have time 
to take a look at this today, unfortunally I hadn't. However, what do 
you think of it?

The eagle has landed....

--mv

<a_little_prayer>dear listmom, instead of a pair o' new shoes I would 
like to have the reply-to-adress of the list set. thank you.... 
</a_little_prayer>

nb: by replying to this post you are free to shorten the subject-line ;-)

Am 7.11.2002 0:31 Uhr +0100 uebermittelte Thorsten Scherler folgende Zeilen:

>Hello group,
>
>I started with the hello world!
>I have followed the first 3 points of chapter 3, more or less ;-)
>
>3. Tutorials
>3.1 the basics
>http://xml.apache.org/cocoon/introduction.html
>http://xml.apache.org/cocoon/userdocs/concepts/index.html
>
>Preparation:
>
>1.) webapps/wyona-cms/sitemap.xmap add:
>			<!-- helloworld @ wyona -->
>			<map:match pattern="helloworld/**">
>				<map:mount uri-prefix="helloworld" 
>src="wyona/cms/pubs/helloworld/sitemap.xmap" check-reload="true" 
>reload-method="synchron"/>
>			</map:match>
>
>2.) unzip helloworld.zip to webapps\wyona-cms\wyona\cms\pubs
>3.1.1 Structure in Wyona (files, directories et cetera)
>
>3.) goto http://localhost:8080/wyona-cms/helloworld/
>3.1.2 static HTML Hello World (only Cocoon)
>
>4.) read the sitemap.xmap I have written some comments
>3.1.3 XML, XSLT Hello World (only Cocoon)
>
>I hope that will help a little bit. I will write a tutrial about it!
>
>Does anybody know whether or not there is something like a tmml 
>(tutorial material markup language)?
>
>
>See the Attachment. -> helloworld.zip
>
>King regard
>Thorsten
>
>Thorsten Scherler wrote:
>>Hello group,
>>
>>I think what we need is to start working on the example page.
>>
>>What Markus said is true. A newbie USER wants to see a publication 
>>he can configure not develope.
>>
>>On the on the other hand Felix wants to show DEVELOPER how wyona 
>>work from ground on.
>>
>>We have to develop that example site anyway so why not keep a 
>>record how we did it.
>>
>>We all agree that wyona needs a better documentation. So if we can 
>>build a "one size fits all" example site, the user could configure 
>>the "individual" components (that the developer will create) to it.
>>
>>I propose the following top level directory structure:
>>docs <- all xml, xhtml
>>resources <- all other
>>stylesheets <- all xsl
>>logic <- all xsp
>>
>>I have never writen a programm in Java. But like cocoon and XML 
>>very much (not yet an expert ;-).
>>How can we get organised?
>>
>>
>><Citation>
>>Markus Vaterlaus wrote:
>>Hi all,
>>Am 25.10.2002 12:06 Uhr +0200 uebermittelte Felix Maeder folgende Zeilen:
>>1) static HTML Hello World (only Cocoon)
>>2) XML, XSLT Hello World (only Cocoon)
>>3) Adding the Wyona Toolbar
>>4) Making the Hello World editable with Xopus and Bitflux
>>5) Making the Hello World publishable
>>6) Making the Hello World creatable (Hello Pluto, Hello Neptun, etc.)
>>7) Adding Access Controlling to the Hello World
>>
>>I don't think this is the best way to go because it takes too long 
>>until you actually have a working publication. If you are newbie 
>>and are trying out a new product, you want to *see* something very 
>>quickly, otherwise you will lose interest pretty soon. I would 
>>propose a more result-oriented, less didactic approach:
>>1. In the distribution there should be a simple "Hello World" publication:
>>- Simple layout
>>- One simple document type (title, subtitles, paragraphs, images, 
>>maybe a list) which is editable through Xopus and Bitflux
>>- A basic navigation
>>- Possibility to upload images
>>- Possibility to create new pages
>>- Possibility to publish pages
>>- Basic access controlling with one user/one role/one policy
>></Citation>
>>
>>"Wyona CMS is an Open-Source Content Management and Publishing 
>>System written in 100% pure Java. It is based on open standards 
>>such as XML and XSLT. One of its core components is Cocoon from the 
>>Apache Software Foundation." http://www.wyona.org
>>
>>Thorsten Scherler
>>
>>
>>_______________________________________________
>>WyonaCMS-dev mailing list
>>[email protected]
>>http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-dev
>>
>
>
>Attachment converted: Macintosh HD:helloworld.zip 1 (pZIP/pZIP) (0007DB6D)


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

Unglaublich, aber wahr: Dilbert lebt!

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