Forrest
  1. Forrest
  2. FOR-814

Add documentation to explain how to aggregate using Cocoon aggregation and using XInclude

    Details

    • Type: Task Task
    • Status: Open
    • Priority: Major Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Labels:
      None

      Description

      Add documentation to explain how to aggregate data.

        Activity

        Show
        David Crossley added a comment - See explanation in the thread: http://mail-archives.apache.org/mod_mbox/forrest-user/200602.mbox/%3cfb9c1a0b0602120053w48afb965k3e30495c51ffe8cc@mail.gmail.com%3e
        Hide
        Ross Gardler added a comment -
        Using XInclude is often easier than modifying the sitemap in this way.

        Here you would provide a sitemap match to generate your required data (see links in Davids mail) and then use XInclude in your source XML similar to your "transform" element above.

        You can see examples of how to do this in the Chart plugin inthe whitebaord. For example "samples/graph1.xml" in the plugin docs includes:

        <!-- combine is the way the datasets are placed together. I imagine "compare", "add" will be\possible among others
        <graph combine="compare">
          <style>
            <!-- Use the specified "style" sheet.
            Format of the url is yet to be specified. -->
            <xi:include href="linechart1.xml"/>
          </style>
        Show
        Ross Gardler added a comment - Using XInclude is often easier than modifying the sitemap in this way. Here you would provide a sitemap match to generate your required data (see links in Davids mail) and then use XInclude in your source XML similar to your "transform" element above. You can see examples of how to do this in the Chart plugin inthe whitebaord. For example "samples/graph1.xml" in the plugin docs includes: <!-- combine is the way the datasets are placed together. I imagine "compare", "add" will be\possible among others <graph combine="compare">   <style>     <!-- Use the specified "style" sheet.     Format of the url is yet to be specified. -->     <xi:include href="linechart1.xml"/>   </style>
        Hide
        David Crossley added a comment -
        Enhanced issue summary. Also removed "Patch Available": the attachment provides some example sitemap and XSL for doing Cocoon sitemap aggregation.
        Show
        David Crossley added a comment - Enhanced issue summary. Also removed "Patch Available": the attachment provides some example sitemap and XSL for doing Cocoon sitemap aggregation.
        Hide
        Carlos Tejo added a comment - - edited
        Example of xinclude attached.

        Also, add <xinclude label="xinclude" href="xinclude.html" description="Test of Xinclude"/>

        in documentation\content\xdocs\site.xml
        Show
        Carlos Tejo added a comment - - edited Example of xinclude attached. Also, add <xinclude label="xinclude" href="xinclude.html" description="Test of Xinclude"/> in documentation\content\xdocs\site.xml
        Hide
        Gavin added a comment -
        Hi Carlos, thanks for your example.

        I have added it to our fresh-site area, so this example will now be part of the default site structure whenever you do a 'forrest seed-sample' to initiate a new site. It will also show shortly on our zone area (forrest.zones.apache.org).
        Show
        Gavin added a comment - Hi Carlos, thanks for your example. I have added it to our fresh-site area, so this example will now be part of the default site structure whenever you do a 'forrest seed-sample' to initiate a new site. It will also show shortly on our zone area (forrest.zones.apache.org).
        Hide
        Gavin added a comment -
        XInclude patch added, perhaps there are more examples required before closing issue?
        Show
        Gavin added a comment - XInclude patch added, perhaps there are more examples required before closing issue?
        Hide
        Gavin added a comment -
        The patch has been reverted for now, nothing wrong with the patch itself, but our xdocs validation now fails if we use it. Currently it seems we have no xinclude support in our xdoc dtd, we are looking at it.

        See comments on mail list at http://marc.info/?l=forrest-dev&m=121649882401304&w=2
        Show
        Gavin added a comment - The patch has been reverted for now, nothing wrong with the patch itself, but our xdocs validation now fails if we use it. Currently it seems we have no xinclude support in our xdoc dtd, we are looking at it. See comments on mail list at http://marc.info/?l=forrest-dev&m=121649882401304&w=2
        Hide
        David Crossley added a comment -
        Thanks Carlos. Now that XInclude is added to the DTD (see FOR-1032), i have added your contribution. I tweaked your explanation a bit. It is not "raw content" - that is a term that we use for something else. I also removed "tab" characters from your files - we don't use them, only spaces.

        I enhanced your example to show use of XInclude in the "site.xml" navigation too. Also added an example of using xpointer, and another example of using XInclude to include a text file.
        Show
        David Crossley added a comment - Thanks Carlos. Now that XInclude is added to the DTD (see FOR-1032 ), i have added your contribution. I tweaked your explanation a bit. It is not "raw content" - that is a term that we use for something else. I also removed "tab" characters from your files - we don't use them, only spaces. I enhanced your example to show use of XInclude in the "site.xml" navigation too. Also added an example of using xpointer, and another example of using XInclude to include a text file.
        Hide
        David Crossley added a comment -
        I left this issue open because the original intent was to provide documentation that shows how to use Cocoon sitemap to do aggregation.
        Show
        David Crossley added a comment - I left this issue open because the original intent was to provide documentation that shows how to use Cocoon sitemap to do aggregation.

          People

          • Assignee:
            Unassigned
            Reporter:
            David Crossley
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:

              Development