You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by "Robert P. J. Day" <rp...@mindspring.com> on 2003/07/08 06:35:17 UTC

how to add a credit image to my forrest pages?

  i'm at a loss as to how to add an additional credit image and
link to my pages.

  in my skinconf.xml file, i can see the format for adding the
credit for the "built-with-forrest-button", and i want to add,
next to that, a "powered by linux" jpg file that i downloaded.

  i've made note of the project images directory, and i've tried
about half a dozen different combinations to get that jpg file
to display, to no avail.

  what's confusing is that the forrest graphic is not part of
the "src" tree -- it's pulled out of the forrest home directory,
so i can't use that as an analogy.

  what is the proper way to add a new credit graphic?  which
is the right directory for additional images?  i've tried both
the resources/images and skin images directory, and neither
seems to work, and i've run out of ideas.

rday

p.s.  the initial forrest.properties is also a bit confusing
in its choice of names.  the "project content" directory is,
by default, src/documentation, despite the fact that there is
a lower-level directory whose name is, in fact, "content".



Re: how to add a credit image to my forrest pages?

Posted by "Robert P. J. Day" <rp...@mindspring.com>.
On Tue, 8 Jul 2003, Jeff Turner wrote:

> On Tue, Jul 08, 2003 at 08:35:52AM -0400, Robert P. J. Day wrote:

> > arrrgh!  after beating on this for a while, i finally took a look at the 
> > page source.  where i had referred to the credit file "blart.jpg", forrest
> > had transmogrified this to "blart.jpg.jpeg".  i'm not convinced that this
> > is an intuitive thing to do.
> 
> Ah yes, so it does :/  Although that shouldn't break anything, as the
> blart.jpg.jpeg file should also exist.

i don't see why.  as a test, i renamed my image file back to .jpg,
and had the credit refer to it by that suffix.  the jpg file was,
in fact, copied under the build directory by precisely that name,
but the page source that was generated referred to the non-existent
file blah.jpg.jpeg, which does not exist anywhere in either the
src or build directory.  ergo, no graphic was displayed on the
page.

OTOH, as soon as i renamed the image file to .jpeg, that was
how the file was named in both the src and build directories, which
agreed with the credit link and everyone (including me) was happy.

as best i can tell, forrest *really* doesn't like .jpg suffixes
and arbitrarily appends a .jpeg suffix to the filename, causing
bad things to happen.

rday

--

Robert P. J. Day
Eno River Technologies
Unix, Linux and Open Source training
Waterloo, Ontario

www.enoriver.com


Re: how to add a credit image to my forrest pages?

Posted by Jeff Turner <je...@apache.org>.
On Tue, Jul 08, 2003 at 08:35:52AM -0400, Robert P. J. Day wrote:
> On Tue, 8 Jul 2003, Jeff Turner wrote:
> 
> > On Tue, Jul 08, 2003 at 12:35:17AM -0400, Robert P. J. Day wrote:
> 
> > >   what is the proper way to add a new credit graphic?  which
> > > is the right directory for additional images?  i've tried both
> > > the resources/images and skin images directory, and neither
> > > seems to work, and i've run out of ideas.
> > 
> > Hmm, works for me.  Have you got the extension right (.jpg, not .jpeg)?
> > 
> > I've just:
> >  - Created a seed project ('mkdir /tmp/fs ; cd /tmp/fs ; forrest seed')
> >  - Added an image:
> >  src/documentation/resources/images/add.jpg
> >  - Edited src/documentation/skinconf.xml and added
> > 
> >     <credit>
> >       <name>Built with Apache Forrest</name>
> >       <url>http://xml.apache.org/forrest/</url>
> >       <image>images/add.jpg</image>
> >       <width>88</width>
> >       <height>31</height>
> >     </credit>
> >  - Run 'forrest' to rebuild.
> 
> arrrgh!  after beating on this for a while, i finally took a look at the 
> page source.  where i had referred to the credit file "blart.jpg", forrest
> had transmogrified this to "blart.jpg.jpeg".  i'm not convinced that this
> is an intuitive thing to do.

Ah yes, so it does :/  Although that shouldn't break anything, as the
blart.jpg.jpeg file should also exist.

--Jeff


> rday
> 

Re: how to add a credit image to my forrest pages?

Posted by "Robert P. J. Day" <rp...@mindspring.com>.
On Tue, 8 Jul 2003, Jeff Turner wrote:

> On Tue, Jul 08, 2003 at 12:35:17AM -0400, Robert P. J. Day wrote:

> >   what is the proper way to add a new credit graphic?  which
> > is the right directory for additional images?  i've tried both
> > the resources/images and skin images directory, and neither
> > seems to work, and i've run out of ideas.
> 
> Hmm, works for me.  Have you got the extension right (.jpg, not .jpeg)?
> 
> I've just:
>  - Created a seed project ('mkdir /tmp/fs ; cd /tmp/fs ; forrest seed')
>  - Added an image:
>  src/documentation/resources/images/add.jpg
>  - Edited src/documentation/skinconf.xml and added
> 
>     <credit>
>       <name>Built with Apache Forrest</name>
>       <url>http://xml.apache.org/forrest/</url>
>       <image>images/add.jpg</image>
>       <width>88</width>
>       <height>31</height>
>     </credit>
>  - Run 'forrest' to rebuild.

arrrgh!  after beating on this for a while, i finally took a look at the 
page source.  where i had referred to the credit file "blart.jpg", forrest
had transmogrified this to "blart.jpg.jpeg".  i'm not convinced that this
is an intuitive thing to do.

rday


Re: how to add a credit image to my forrest pages?

Posted by Jeff Turner <je...@apache.org>.
On Tue, Jul 08, 2003 at 12:35:17AM -0400, Robert P. J. Day wrote:
> 
>   i'm at a loss as to how to add an additional credit image and
> link to my pages.
> 
>   in my skinconf.xml file, i can see the format for adding the
> credit for the "built-with-forrest-button", and i want to add,
> next to that, a "powered by linux" jpg file that i downloaded.
> 
>   i've made note of the project images directory, and i've tried
> about half a dozen different combinations to get that jpg file
> to display, to no avail.
> 
>   what's confusing is that the forrest graphic is not part of
> the "src" tree -- it's pulled out of the forrest home directory,
> so i can't use that as an analogy.

Anything you put in $PROJECT/src/documentation/resources/images/ should
be available with an 'images/' prefix.

>   what is the proper way to add a new credit graphic?  which
> is the right directory for additional images?  i've tried both
> the resources/images and skin images directory, and neither
> seems to work, and i've run out of ideas.

Hmm, works for me.  Have you got the extension right (.jpg, not .jpeg)?

I've just:
 - Created a seed project ('mkdir /tmp/fs ; cd /tmp/fs ; forrest seed')
 - Added an image:
 src/documentation/resources/images/add.jpg
 - Edited src/documentation/skinconf.xml and added

    <credit>
      <name>Built with Apache Forrest</name>
      <url>http://xml.apache.org/forrest/</url>
      <image>images/add.jpg</image>
      <width>88</width>
      <height>31</height>
    </credit>
 - Run 'forrest' to rebuild.

> rday
> 
> p.s.  the initial forrest.properties is also a bit confusing
> in its choice of names.  the "project content" directory is,
> by default, src/documentation, despite the fact that there is
> a lower-level directory whose name is, in fact, "content".

Yes, it's an unfortunate accident of history.  Perhaps we should fix it
for 0.5, since we'll be breaking everyone's sitemaps anyway..


--Jeff