Sitemap: 'cocoon:' protocol

[Brian Topping <to...@digidemic.com>]

Hi all,

I read in the release notes about the inclusion of the 'cocoon:' protocol and the nifty hack to make 'cocoon://' reference from the base of the main sitemap and 'cocoon:/' reference from the current sitemap.  Is that documented anywhere else but the release notes?

Also, what is the function of 'cocoon:raw:'?  Does the same main sitemap/subsitemap distinction hold true with the trailing slashes here as well?

I'll put some doc patches together as I get these two figured out (if they aren't already documented...)

Thanks,

Brian

_________________________________________________________ 
If you have some ice cream, I will give it to you. 
If you have no ice cream, I will take it away from you. 
         - Ice Cream Koan


---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>

To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>

Re: Sitemap: 'cocoon:' protocol

[Diana Shannon <sh...@apache.org>]

On Monday, June 3, 2002, at 02:54  AM, Brian Topping wrote:

> I read in the release notes about the inclusion of the 'cocoon:' 
> protocol and the nifty hack to make 'cocoon://' reference from the base 
> of the main sitemap and 'cocoon:/' reference from the current sitemap.  
> Is that documented anywhere else but the release notes?

There is a small amount of info in the userdocs/concepts/sitemap.xml 
(starting around line 950).

>
> Also, what is the function of 'cocoon:raw:'?  Does the same main 
> sitemap/subsitemap distinction hold true with the trailing slashes here 
> as well?
>
> I'll put some doc patches together as I get these two figured out (if 
> they aren't already documented...)

That's fantastic. Follow instructions on how to submit a patch and 
submit via Bugzilla (currently in HEAD, soon to be in release). If you 
don't have the HEAD cvs, you can use ViewCVS:
   http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-
cocoon2/src/documentation/xdocs/howto/howto-
bugzilla.xml?rev=1.3&content-type=text/plain

   http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-
cocoon2/src/documentation/xdocs/howto/howto-
patch.xml?rev=1.1&content-type=text/plain

If you are a definite on contributing, let me know. I'm also interested 
to know where you think it belongs within the given doc structure.  I'll 
put your name on a soon-to-be committed list of docs in process so no 
one else duplicates your efforts.

Diana




---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>

To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>

RE: Sitemap: 'cocoon:' protocol

[Vadim Gritsenko <va...@verizon.net>]

> From: Brian Topping [mailto:topping@digidemic.com]
> 
> Hi all,
> 
> I read in the release notes about the inclusion of the 'cocoon:'
protocol and
> the nifty hack to make 'cocoon://' reference from the base of the main
sitemap
> and 'cocoon:/' reference from the current sitemap.  Is that documented
> anywhere else but the release notes?

1) http://xml.apache.org/cocoon/userdocs/concepts/sitemap.html:
"The following list of examples summarizes some useful part sources:"
and below.
 
2)
http://cvs.apache.org/viewcvs.cgi/xml-cocoon2/src/webapp/sub/sitemap.xma
p?rev=1.3&content-type=text/vnd.viewcvs-markup

and

http://cvs.apache.org/viewcvs.cgi/xml-cocoon2/src/webapp/sub/docs/sample
s.xml?rev=1.5&content-type=text/vnd.viewcvs-markup


> Also, what is the function of 'cocoon:raw:'?  Does the same main
> sitemap/subsitemap distinction hold true with the trailing slashes
here as
> well?

In "raw:" mode request parameters of the original request are ignored.

I.e., suppose you requested URL:

   http://my/cocoon/page?x=y

And, during processing of this page, you access:

   cocoon://internal?a=b

In "internal" page, you will have access to parameter 'a' and 'x'.

If you have URL like:

   cocoon:raw://internal?a=b 

The only parameter will be 'a', 'x' won't be available.

(See RequestWrapper.java)


Vadim

> I'll put some doc patches together as I get these two figured out (if
they
> aren't already documented...)
> 
> Thanks,
> 
> Brian



---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>

To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>