You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by is...@cocoondev.org on 2005/05/24 22:54:55 UTC

[JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Message:

  A new issue has been created in JIRA.

---------------------------------------------------------------------
View the issue:
  http://issues.cocoondev.org//browse/FOR-505

Here is an overview of the issue:
---------------------------------------------------------------------
        Key: FOR-505
    Summary: Allow the retrieval of raw html files
       Type: Improvement

     Status: Unassigned
   Priority: Minor

    Project: Forrest
   Versions:
             0.7-dev

   Assignee: 
   Reporter: Ross Gardler

    Created: Tue, 24 May 2005 3:53 PM
    Updated: Tue, 24 May 2005 3:53 PM

Description:
With the merging of the raw content directory and the xdocs directory it is no longer possible to retrieve the raw, unprocessed version of an HTML file.

The raw HTML files were removed from the fresh-site in revision 178279. When we have added support for raw HTML files back into the system we should revive these files as a demo.


---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://issues.cocoondev.org//secure/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Posted by Ross Gardler <rg...@apache.org>.
Ferdinand Soethe wrote:
> 
> 
> 
> Ross Gardler wrote:
> 
> 
>>>And would I still have an additional separate entry in the sitemap to
>>>have /old_site_1/index.htm on the menu or would this have to be
>>>within the rawContent element.
> 
> 
>>Do you mean "would I still have an additional separate entry in the 
>>*skins.xml*"?
> 
> 
> Sorry, I was writing bullshit. Of course I meant

LOL - so was I, at least we understood what we intended to say!

Ross

Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

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



Ross Gardler wrote:

>> And would I still have an additional separate entry in the sitemap to
>> have /old_site_1/index.htm on the menu or would this have to be
>> within the rawContent element.

> Do you mean "would I still have an additional separate entry in the 
> *skins.xml*"?

Sorry, I was writing bullshit. Of course I meant

> And would I still have an additional separate entry in the site.xml to
>                                                            ^^^^^^^^
> have /old_site_1/index.htm on the menu or would this have to be
> within the rawContent element.

But your reply has already made this clear this: I do need to
reference a file to show it one a menu since rawcontent will only
provide the processing hints.

Thanks

--
Ferdinand Soethe


Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Posted by Ross Gardler <rg...@apache.org>.
Ferdinand Soethe wrote:
> Ross Gardler wrote:
> 
> 
>>Anyway, +1 for implementing it instead of  the skinHTMLSources=true
>>workaround.
> 
> 
> Pardon my ignorance but is this
> 
> 
>>A third possibility that is a marrying of the two is elements in
>>site.xml to make it much more like the Ant fileset idea, like this:
>>
>><!-- everything in old_site directory -->
>><rawContent dir="/old_site/**"/>
>>
>><!-- everything in 0.6_docs, except the forums -->
>><rawContent dir="/0.6_docs/**">
>>   <exclude name="forums/**"/>
>></rawContent>
>>
>><!-- everything in 0.6_docs, except all files in forums except the 
> 
> index.html file -->>
> 
>><rawContent dir="/0.6_docs/**">
>>   <exclude name="forums/**"/>
>>   <exclude name="forums/**/index.html"/>
>></rawContent>
>>
>>This leaves site.xml easily readable, allows such content to be provided 
>>in an external file if there is no way of generating it from another 
>>type of site descriptor file and allows us to describe pages not linked 
>>to in site.xml.
> 
> 
> what we are going to implement now?

Yes, if the concept can be brought to a working design. Of course that 
is the hard part.

> And if so, what would it look like if I had raw content in more than
> one branch? For example could I have
> 
> <rawContent dir="/old_site_1/**"/>

> <rawContent dir="/old_site_2/**"/>

Just add an element for each of the matches that represent raw content, 
each with its own include and exclude patterns.

> And would I still have an additional separate entry in the sitemap to
> have /old_site_1/index.htm on the menu or would this have to be
> within the rawContent element.

Do you mean "would I still have an additional separate entry in the 
*skins.xml*"?

If so, yes, there would be no need to change any other functionlaity in 
Forrest.

What would happen is that when we receive a request for /old_site_1/**
the sitemap would first look in the config to see if it is raw content. 
If it is it would read the content and serve it. If it isn't processing 
would proceed as normal.

When I find the time I'll write up a proposal about how to implement this.

Ross

Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Posted by Ferdinand Soethe <sa...@soethe.net>.
Ross Gardler wrote:

> Anyway, +1 for implementing it instead of  the skinHTMLSources=true
> workaround.

Pardon my ignorance but is this

> A third possibility that is a marrying of the two is elements in
> site.xml to make it much more like the Ant fileset idea, like this:
> 
> <!-- everything in old_site directory -->
> <rawContent dir="/old_site/**"/>
> 
> <!-- everything in 0.6_docs, except the forums -->
> <rawContent dir="/0.6_docs/**">
>    <exclude name="forums/**"/>
> </rawContent>
> 
> <!-- everything in 0.6_docs, except all files in forums except the 
index.html file -->>
> <rawContent dir="/0.6_docs/**">
>    <exclude name="forums/**"/>
>    <exclude name="forums/**/index.html"/>
> </rawContent>
> 
> This leaves site.xml easily readable, allows such content to be provided 
> in an external file if there is no way of generating it from another 
> type of site descriptor file and allows us to describe pages not linked 
> to in site.xml.

what we are going to implement now?

And if so, what would it look like if I had raw content in more than
one branch? For example could I have

<rawContent dir="/old_site_1/**"/>

and

<rawContent dir="/old_site_2/**"/>


And would I still have an additional separate entry in the sitemap to
have /old_site_1/index.htm on the menu or would this have to be
within the rawContent element.

Thanks

--
Ferdinand Soethe


Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Posted by Ross Gardler <rg...@apache.org>.
David Crossley wrote:
> Ross Gardler wrote:
> 
>>[ snip ]
>>
>>We could add a new skinconf property to define the behaviour for *.html 
>>files in xdocs we can tell people affected by this issue to make their 
>>embedded content ihtml and their raw content html. i.e.
>>
>><!-- HTML files in the XDoc directory can  wither be passed unprocessed 
>>to the client, or they can be skinned like any other content. If you set
>>this setting to false, you can include skinned files by giving them the
>>ihtml extension. -->
>>
>><skinHTMLSources>true</skinHTMLSources>
>>
>>The result is, setting skinHTML to false will give the same behaviour as 
>>0.6 We could make this the default in order to minimise the upgrade 
>>behaviour.
> 
> 
> If we implement this workaround, then i reckon that the default
> should be "true". It would be easier to explain the "false" case
> and it would be a smaller number of people affected.
> 
> However, it forces them to change their filename extensions.
> That would be difficult for the main use-case, which is to include
> a set of existing *.html docs as part of the site.
> 
> The thread "RT: RAW content" that is linked from issue FOR-505
> ended with an interesting idea about using site.xml to specify
> exclude/include patterns.
> http://marc.theaimsgroup.com/?l=forrest-dev&m=110172196321097
> It seems to be independent from the "locationmap" ideas discussed
> earlier in that thread. Would that be better to implement now,
> rather than the skinHTMLSources=true workaround?

Wow, that is the most focused rambling thread I have read for a long 
time, all that discussion to come around to such an elegant solution. 
Kudos to everyone involved (and thank goodness for mail archives, I had 
completely forgotten the whole thing). A tip for the wary read the first 
few and the last email, skip everything in between it goes round many 
houses to get to the last mail.

Anyway, +1 for implementing it instead of  the skinHTMLSources=true 
workaround.

I'm game for having a go at it, but I'm not sure when I will be able to 
so others should feel free to jump in.

Ross



Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Posted by David Crossley <cr...@apache.org>.
Ross Gardler wrote:
> [ snip ]
> 
> We could add a new skinconf property to define the behaviour for *.html 
> files in xdocs we can tell people affected by this issue to make their 
> embedded content ihtml and their raw content html. i.e.
> 
> <!-- HTML files in the XDoc directory can  wither be passed unprocessed 
> to the client, or they can be skinned like any other content. If you set
> this setting to false, you can include skinned files by giving them the
> ihtml extension. -->
> 
> <skinHTMLSources>true</skinHTMLSources>
> 
> The result is, setting skinHTML to false will give the same behaviour as 
> 0.6 We could make this the default in order to minimise the upgrade 
> behaviour.

If we implement this workaround, then i reckon that the default
should be "true". It would be easier to explain the "false" case
and it would be a smaller number of people affected.

However, it forces them to change their filename extensions.
That would be difficult for the main use-case, which is to include
a set of existing *.html docs as part of the site.

The thread "RT: RAW content" that is linked from issue FOR-505
ended with an interesting idea about using site.xml to specify
exclude/include patterns.
http://marc.theaimsgroup.com/?l=forrest-dev&m=110172196321097
It seems to be independent from the "locationmap" ideas discussed
earlier in that thread. Would that be better to implement now,
rather than the skinHTMLSources=true workaround?

--David

Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Posted by Ross Gardler <rg...@apache.org>.
David Crossley wrote:
>>---------------------------------------------------------------------
>>View the issue:
>>  http://issues.cocoondev.org//browse/FOR-505
>>
>>Here is an overview of the issue:
>>---------------------------------------------------------------------
>>        Key: FOR-505
>>    Summary: Allow the retrieval of raw html files
>>       Type: Improvement
>>
>>     Status: Unassigned
>>   Priority: Minor
>>
>>    Project: Forrest
>>   Versions:
>>             0.7-dev
>>
>>   Assignee: 
>>   Reporter: Ross Gardler
>>
>>    Created: Tue, 24 May 2005 3:53 PM
>>    Updated: Tue, 24 May 2005 3:53 PM
>>
>>Description:
>>With the merging of the raw content directory and the xdocs directory it is no longer possible to retrieve the raw, unprocessed version of an HTML file.
>>
>>The raw HTML files were removed from the fresh-site in revision 178279. When we have added support for raw HTML files back into the system we should revive these files as a demo.
> 
> 
> Argh, i was afraid that the change to the way content was processed
> was going to cause a problem. That is an important change which is
> going to bust some projects.

The issue was raised (by Nicola I believe) before the change was made, 
but there was no -1 just verbal objections, then the change got made.

If you believe it will break some sites (and it sure could) we could 
implement a "hack" solution for 0.7 and then resolve it properly in 0.8 
with per page configs.

People using 0.7-dev will already have been stung by this and so we need 
not worry about them.

People using 0.6 will have been using the "ihtml" extension for embedded 
content. This is now deprecated but still works so their embedded 
content is not the problem. It is raw html that they are serving that is 
the issue.

We could add a new skinconf property to define the behaviour for *.html 
files in xdocs we can tell people affected by this issue to make their 
embedded content ihtml and their raw content html. i.e.

<!-- HTML files in the XDoc directory can  wither be passed unprocessed 
to the client, or they can be skinned like any other content. If you set
this setting to false, you can include skinned files by giving them the
ihtml extension. -->

<skinHTMLSources>true</skinHTMLSources>

The result is, setting skinHTML to false will give the same behaviour as 
0.6 We could make this the default in order to minimise the upgrade 
behaviour.

Slightly offtopic: this actually "feels" like a pretty good solution 
since we will be able to write skins that do things like put a banner on 
the top of a "non-skinned" page:

<skinHTMLSources>tabsOnly</skinHTMLSources>

Ross

Re: [JIRA] Created: (FOR-505) Allow the retrieval of raw html files

Posted by David Crossley <cr...@apache.org>.
> ---------------------------------------------------------------------
> View the issue:
>   http://issues.cocoondev.org//browse/FOR-505
> 
> Here is an overview of the issue:
> ---------------------------------------------------------------------
>         Key: FOR-505
>     Summary: Allow the retrieval of raw html files
>        Type: Improvement
> 
>      Status: Unassigned
>    Priority: Minor
> 
>     Project: Forrest
>    Versions:
>              0.7-dev
> 
>    Assignee: 
>    Reporter: Ross Gardler
> 
>     Created: Tue, 24 May 2005 3:53 PM
>     Updated: Tue, 24 May 2005 3:53 PM
> 
> Description:
> With the merging of the raw content directory and the xdocs directory it is no longer possible to retrieve the raw, unprocessed version of an HTML file.
> 
> The raw HTML files were removed from the fresh-site in revision 178279. When we have added support for raw HTML files back into the system we should revive these files as a demo.

Argh, i was afraid that the change to the way content was processed
was going to cause a problem. That is an important change which is
going to bust some projects.

--David

[JIRA] Updated: (FOR-505) Allow the retrieval of raw html files

Posted by is...@cocoondev.org.
The following issue has been updated:

    Updater: Ross Gardler (mailto:ross@saafe.org)
       Date: Wed, 1 Jun 2005 2:56 PM
    Changes:
             Fix Version changed to 0.7-dev
    ---------------------------------------------------------------------
For a full history of the issue, see:

  http://issues.cocoondev.org//browse/FOR-505?page=history

---------------------------------------------------------------------
View the issue:
  http://issues.cocoondev.org//browse/FOR-505

Here is an overview of the issue:
---------------------------------------------------------------------
        Key: FOR-505
    Summary: Allow the retrieval of raw html files
       Type: Improvement

     Status: Unassigned
   Priority: Minor

    Project: Forrest
   Fix Fors:
             0.7-dev
   Versions:
             0.7-dev

   Assignee: 
   Reporter: Ross Gardler

    Created: Tue, 24 May 2005 3:53 PM
    Updated: Wed, 1 Jun 2005 2:56 PM

Description:
With the merging of the raw content directory and the xdocs directory it is no longer possible to retrieve the raw, unprocessed version of an HTML file.

The raw HTML files were removed from the fresh-site in revision 178279. When we have added support for raw HTML files back into the system we should revive these files as a demo.


---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://issues.cocoondev.org//secure/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


[JIRA] Commented: (FOR-505) Allow the retrieval of raw html files

Posted by is...@cocoondev.org.
The following comment has been added to this issue:

     Author: Ross Gardler
    Created: Tue, 24 May 2005 4:11 PM
       Body:
In addition the following files in fresh-site were removed as part of revision 178282:

samples/test3.html
samples/subdir/test4.html
---------------------------------------------------------------------
View this comment:
  http://issues.cocoondev.org//browse/FOR-505?page=comments#action_12427

---------------------------------------------------------------------
View the issue:
  http://issues.cocoondev.org//browse/FOR-505

Here is an overview of the issue:
---------------------------------------------------------------------
        Key: FOR-505
    Summary: Allow the retrieval of raw html files
       Type: Improvement

     Status: Unassigned
   Priority: Minor

    Project: Forrest
   Versions:
             0.7-dev

   Assignee: 
   Reporter: Ross Gardler

    Created: Tue, 24 May 2005 3:53 PM
    Updated: Tue, 24 May 2005 4:11 PM

Description:
With the merging of the raw content directory and the xdocs directory it is no longer possible to retrieve the raw, unprocessed version of an HTML file.

The raw HTML files were removed from the fresh-site in revision 178279. When we have added support for raw HTML files back into the system we should revive these files as a demo.


---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://issues.cocoondev.org//secure/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


[JIRA] Commented: (FOR-505) Allow the retrieval of raw html files

Posted by is...@cocoondev.org.
The following comment has been added to this issue:

     Author: David Crossley
    Created: Mon, 30 May 2005 8:41 PM
       Body:
Discussion about a solution is at:
http://marc.theaimsgroup.com/?t=111696814000010
---------------------------------------------------------------------
View this comment:
  http://issues.cocoondev.org//browse/FOR-505?page=comments#action_12453

---------------------------------------------------------------------
View the issue:
  http://issues.cocoondev.org//browse/FOR-505

Here is an overview of the issue:
---------------------------------------------------------------------
        Key: FOR-505
    Summary: Allow the retrieval of raw html files
       Type: Improvement

     Status: Unassigned
   Priority: Minor

    Project: Forrest
   Versions:
             0.7-dev

   Assignee: 
   Reporter: Ross Gardler

    Created: Tue, 24 May 2005 3:53 PM
    Updated: Mon, 30 May 2005 8:41 PM

Description:
With the merging of the raw content directory and the xdocs directory it is no longer possible to retrieve the raw, unprocessed version of an HTML file.

The raw HTML files were removed from the fresh-site in revision 178279. When we have added support for raw HTML files back into the system we should revive these files as a demo.


---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://issues.cocoondev.org//secure/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


[JIRA] Commented: (FOR-505) Allow the retrieval of raw html files

Posted by is...@cocoondev.org.
The following comment has been added to this issue:

     Author: Ross Gardler
    Created: Wed, 25 May 2005 8:16 AM
       Body:
See the RT thread at http://marc.theaimsgroup.com/?l=forrest-dev&m=110145900227224&w=2
---------------------------------------------------------------------
View this comment:
  http://issues.cocoondev.org//browse/FOR-505?page=comments#action_12429

---------------------------------------------------------------------
View the issue:
  http://issues.cocoondev.org//browse/FOR-505

Here is an overview of the issue:
---------------------------------------------------------------------
        Key: FOR-505
    Summary: Allow the retrieval of raw html files
       Type: Improvement

     Status: Unassigned
   Priority: Minor

    Project: Forrest
   Versions:
             0.7-dev

   Assignee: 
   Reporter: Ross Gardler

    Created: Tue, 24 May 2005 3:53 PM
    Updated: Wed, 25 May 2005 8:16 AM

Description:
With the merging of the raw content directory and the xdocs directory it is no longer possible to retrieve the raw, unprocessed version of an HTML file.

The raw HTML files were removed from the fresh-site in revision 178279. When we have added support for raw HTML files back into the system we should revive these files as a demo.


---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://issues.cocoondev.org//secure/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira