You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@forrest.apache.org by Ferdinand Soethe <sa...@soethe.net> on 2005/02/18 15:17:14 UTC

Re[2]: Q: Integrate multipage externally generated content

Hi Ross,

looks like another exciting Howto candidate. Thanks for taking the time.


>>    Unfortunately I found no more info on
>> 
>>    - the required structure of book.xml
>>    - how to reference it on site and tabs (or not at all)

RG> Do a "forrest seed" and look inside the samples directory.

Ah, its not named book.xml, no wonder my file search didn't work.
I found it and will do some experimenting to understand what and how
it's doing this.

>> 3. Can I use directory-based selection for only parts of my Forrest?
>>    I looks like it for all or none of the site.

RG> Yesterday I committed a small change to how site.xml and tabs.xml are
RG> generated for this very reason. You are now able to override the 
RG> generation of these two files in a project sitemap. So therefore the
RG> answer is yes, just create your own pipeline that aggregates the static
RG> parts of your structure with the dir generated parts.

Which is basically a nice wrapper of my solution 1, is it? my own
pipeline would still have to grap the static parts of site and tabs
and 'wrap' them around the dynamically generated parts.

>> 4. Is there another way to generate the courses-sections of site and
>>    tabs in my transformation, put it into separate files and have Forrest
>>    include these into site and tabs when compiling the site?

RG> If you use the IMSManifest plugin (this is exactly why I built it), yes.
RG> But this requires you to use IMS Manifests rather than site.xml and
RG> tabs.xml. The Burrokeet project ( http://www.burrokeet.org ) provides
RG> some assistance in doing this kind of thing, but it is early days.

Will try and understand this (and come back with losts more questions
...:-))

RG> Finally, last night I started working on the locationmap feature of
RG> Forrest. This is not due until 0.8 but I need it, for a remarkably
RG> similar use case in the coming months. However, I'm not sure when I will
RG> complete work on this.

I looked up locationmap in the dev-list and found a mail on
'LocationMapModule' of Oct 17th 2003. Unfortunately I didn't even
remotely understand what Unico was writing about and even less why
this would help with our problem.

Is there info on the locationmaps to learn more?

Thanks
Ferdinand Soethe



Re: Q: Integrate multipage externally generated content

Posted by Dave Brondsema <da...@brondsema.net>.
Ferdinand Soethe wrote:
> I'm about to put the changes to the OO-Plugin into the issue tracker.
> I involves adding and changing files. Should I still create patches
> for the changes files or just create a zip of all changes files?
>
> Thanks,
> Ferdinand Soethe
>

Patches are preferred.  If you want to create a zip of all the patch
files, that's fine.

--
Dave Brondsema : dave@brondsema.net
http://www.splike.com : programming
http://csx.calvin.edu : student org
http://www.brondsema.net : personal

Re: Q: Integrate multipage externally generated content

Posted by Ross Gardler <rg...@apache.org>.
Ferdinand Soethe wrote:
> I'm about to put the changes to the OO-Plugin into the issue tracker.
> I involves adding and changing files. Should I still create patches
> for the changes files or just create a zip of all changes files?

Create a patch for the changed files and zip that with the added files.

Thanks,

Ross

Re: Q: Integrate multipage externally generated content

Posted by Ferdinand Soethe <sa...@soethe.net>.
I'm about to put the changes to the OO-Plugin into the issue tracker.
I involves adding and changing files. Should I still create patches
for the changes files or just create a zip of all changes files?

Thanks,
Ferdinand Soethe


Re: Q: Integrate multipage externally generated content

Posted by Ferdinand Soethe <sa...@soethe.net>.
David Crossley wrote:

DC> But the locationmap is not yet implemented and not yet fully conceptualised.
DC> We need to discuss technical things on the dev list. If we discuss technical
DC> on users@ then we will frighten people away.

OK, sorry. It looked to me like a finished concept that was waiting to
be implemented. So I'll keep a eye on this on the dev list.

--
Ferdinand Soethe



Re: Q: Integrate multipage externally generated content

Posted by David Crossley <cr...@apache.org>.
Ferdinand Soethe wrote:
> RG> David was only referring to the locationmap stuff - this is not yet a
> RG> part of Forrest and so of no use to users. Sorry, I should have been
> RG> clearer.
> 
> Wouldn't it make sense to start explaining/documenting features as soon as they
> are conceptualized or implemented? Or is this to be an internal
> mechanism that users would not apply it? I'm confused.

But the locationmap is not yet implemented and not yet fully conceptualised.
We need to discuss technical things on the dev list. If we discuss technical
on users@ then we will frighten people away.

--David

Re: Q: Integrate multipage externally generated content

Posted by Ferdinand Soethe <sa...@soethe.net>.
David Crossley wrote:

DC> It deserves some documentation. At least it is mentioned in the
DC> docs/dev/changes.html but we need more documentation.


I will write something probably in time for 0.7.

--
Ferdinand Soethe



Re: Q: Integrate multipage externally generated content

Posted by David Crossley <cr...@apache.org>.
Ferdinand Soethe wrote:
> Sjur Moshagen wrote:
> 
> SM>  From the author of that feature request: Here's a short example of how
> SM> we have used it:-)
> 
> Thanks for the details. This is a great feature!

It deserves some documentation. At least it is mentioned in the
docs/dev/changes.html but we need more documentation.

--David

Re: Q: Integrate multipage externally generated content

Posted by Ferdinand Soethe <sa...@soethe.net>.

Sjur Moshagen wrote:

SM>  From the author of that feature request: Here's a short example of how
SM> we have used it:-)

Thanks for the details. This is a great feature!

Ferdinand Soethe



Re: Q: Integrate multipage externally generated content

Posted by Sjur Moshagen <sj...@mac.com>.
På 22. feb. 2005 kl. 14.40 skrev Ferdinand Soethe:

> RG> However, I have remembered another way of doing what you want to 
> do, it
> RG> is a new feature and currently undocumented other than at
> RG> http://issues.cocoondev.org/browse/FOR-417
>
> Cool. That looks just like the thing I was looking for. Will try to
> implement an example to understand it better. Would the fragments for
> site and tabs have the same header as the main files?

 From the author of that feature request: Here's a short example of how 
we have used it:-)

In site.xml:

<site xmlns="http://apache.org/forrest/linkmap/1.0" href="" 
label="MyProj" tab="" >
     <about label="Home" tab="Home" >
         <index   href="index.html" label="Index" description="Welcome 
to divvun.no" />
         <changes href="changes.html" label="Changes" description="The 
projects history" />
         <todo    href="todo.html" label="Todo" description="The plan 
for the project" />
     </about>

     <xi:include href="doc/site-frag.xml#xpointer(/tech/*)" 
xmlns:xi="http://www.w3.org/2001/XInclude"/>

</site>


In site-frag.xml:

<?xml version="1.0" encoding="UTF-8"?>
<tech>
   <techdoc href="doc/" label="Technical doc" tab="TechDoc">
     <index href="intro.html" label="Introduction" />
   </techdoc>
   <!-- add entries ad lib just as in site.xml -->
</tech>

The same for tabs.xml and tabs-frag.xml.

The outer element in both fragment files are required to make the files 
valid XML files. Hence the reference to the content of that element in 
the XInclude.

It works like a charm, and having the full power of XInclude makes for 
a very flexible solution.

Sjur


Re: Q: Integrate multipage externally generated content

Posted by Ferdinand Soethe <sa...@soethe.net>.
Hi Ross,

RG> David was only referring to the locationmap stuff - this is not yet a
RG> part of Forrest and so of no use to users. Sorry, I should have been
RG> clearer.

Wouldn't it make sense to start explaining/documenting features as soon as they
are conceptualized or implemented? Or is this to be an internal
mechanism that users would not apply it? I'm confused.

RG> However, I have remembered another way of doing what you want to do, it
RG> is a new feature and currently undocumented other than at 
RG> http://issues.cocoondev.org/browse/FOR-417

Cool. That looks just like the thing I was looking for. Will try to
implement an example to understand it better. Would the fragments for
site and tabs have the same header as the main files?

Thanks,
Ferdinand



Re: Q: Integrate multipage externally generated content

Posted by Ross Gardler <rg...@apache.org>.
Ferdinand Soethe wrote:
> David Crossley wrote:
> 
> DC> http://issues.cocoondev.org/browse/FOR-200
> 
> DC> However, this is a topic for the dev list.
> 
> If I may disagree, David. My question that triggered this response is
> actually more a user level question and was asked in preparing for
> writing another howto.
> 
> But in order to that, I need a user level understanding of the
> intended role and function of locationmaps. Which none of the threads
> quoted in FOR-200 really does. In fact, as I said, I didn't even
> understand most of the tech level explanation.

David was only referring to the locationmap stuff - this is not yet a 
part of Forrest and so of no use to users. Sorry, I should have been 
clearer.

However, I have remembered another way of doing what you want to do, it 
is a new feature and currently undocumented other than at 
http://issues.cocoondev.org/browse/FOR-417

Ross

Re: Q: Integrate multipage externally generated content

Posted by Ferdinand Soethe <sa...@soethe.net>.
David Crossley wrote:

DC> http://issues.cocoondev.org/browse/FOR-200

DC> However, this is a topic for the dev list.

If I may disagree, David. My question that triggered this response is
actually more a user level question and was asked in preparing for
writing another howto.

But in order to that, I need a user level understanding of the
intended role and function of locationmaps. Which none of the threads
quoted in FOR-200 really does. In fact, as I said, I didn't even
understand most of the tech level explanation.

--
Ferdinand Soethe



Re: Q: Integrate multipage externally generated content

Posted by David Crossley <cr...@apache.org>.
Ferdinand Soethe wrote:
> Ross Gardler wrote:
> RG> Finally, last night I started working on the locationmap feature of
> RG> Forrest. This is not due until 0.8 but I need it, for a remarkably
> RG> similar use case in the coming months. However, I'm not sure when I will
> RG> complete work on this.
> 
> I looked up locationmap in the dev-list and found a mail on
> 'LocationMapModule' of Oct 17th 2003. Unfortunately I didn't even
> remotely understand what Unico was writing about and even less why
> this would help with our problem.
> 
> Is there info on the locationmaps to learn more?

http://issues.cocoondev.org/browse/FOR-200

However, this is a topic for the dev list.

--David