You are viewing a plain text version of this content. The canonical link for it is here.
Posted to doxia-dev@maven.apache.org by Dennis Lundberg <de...@apache.org> on 2007/11/18 20:23:59 UTC

Re: svn commit: r595592 - /maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm

Should we be hardcoding the width and height of the PoweredBy logo? What 
if someone wants to use a differently sized logo? It would then be 
shrinked or expanded, resulting in a possibly distorted image.

ltheussl@apache.org wrote:
> Author: ltheussl
> Date: Fri Nov 16 00:49:16 2007
> New Revision: 595592
> 
> URL: http://svn.apache.org/viewvc?rev=595592&view=rev
> Log:
> [DOXIASITETOOLS-3] Add titles to hrefs, tweaks to powered by
> Submitted by: Tim Pizey
> 
> Modified:
>     maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm
> 
> Modified: maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm
> URL: http://svn.apache.org/viewvc/maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm?rev=595592&r1=595591&r2=595592&view=diff
> ==============================================================================
> --- maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm (original)
> +++ maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm Fri Nov 16 00:49:16 2007
> @@ -11,9 +11,9 @@
>  #macro ( banner $banner $id )
>    #if ( $banner )
>      #if( $banner.href )
> -      <a href="$banner.href" id="$id">
> +      <a href="$banner.href" id="$id" #if( $banner.alt ) title="$banner.alt" #end >
>      #else
> -        <span id="$id">
> +        <div id="$id">
>      #end
>  
>      #if( $banner.src )
> @@ -25,7 +25,7 @@
>          #if ( $banner.alt )
>              #set ( $alt = $banner.alt )
>          #else
> -            #set ( $alt = "" )
> +            #set ( $alt = $banner.name )
>          #end
>          <img src="$src" alt="$alt" />
>      #else
> @@ -35,7 +35,7 @@
>      #if( $banner.href )
>          </a>
>      #else
> -        </span>
> +        </div>
>      #end
>    #end
>  #end
> @@ -76,7 +76,7 @@
>      #foreach( $subitem in $item.items )
>        #set ( $subitemHref = $PathTool.calculateLink( $subitem.href, $relativePath ) )
>        #set ( $subitemHref = $subitemHref.replaceAll( "\\", "/" ) )
> -
> +      #set ( $display = false )
>        #if ( $alignedFileName == $subitemHref )
>          #set ( $display = true )
>        #end
> @@ -187,6 +187,9 @@
>      #else
>        #set ( $versionPosition = "left" )
>      #end
> +  #else
> +    #set ( $version = "" )
> +    #set ( $versionPosition = "left" )
>    #end
>  
>    #set ( $breadcrumbs = $decoration.body.breadcrumbs )
> @@ -272,17 +275,33 @@
>              <a href="$href" title="$name" class="poweredBy">
>                #set ( $img = $PathTool.calculateLink( $img, $relativePath ) )
>                #set ( $img = $img.replaceAll( "\\", "/" ) )
> -              <img alt="$name" src="$img" />
> +              <img  class="poweredBy"  
> +                    alt="$name" 
> +                    src="$img" 
> +                    width="90"
> +                    height="30"
> +              />
>              </a>
>          #end
>          #if( $poweredBy.isEmpty() )
>            <a href="http://maven.apache.org/" title="$i18n.getString( "site-renderer", $locale, "template.builtby" ) Maven" class="poweredBy">
> -            <img alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) Maven" src="$relativePath/images/logos/maven-feather.png"></img>
> +            <img class="poweredBy" 
> +                 alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) Maven" 
> +                 src="$relativePath/images/logos/maven-feather.png" 
> +                 width="90"
> +                 height="30"
> +                 border="1" />
>            </a>
>          #end
>      #else
>          <a href="http://maven.apache.org/" title="$i18n.getString( "site-renderer", $locale, "template.builtby" ) Maven" class="poweredBy">
> -          <img alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) Maven" src="$relativePath/images/logos/maven-feather.png"></img>
> +          <img class="poweredBy" 
> +               alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) Maven" 
> +               src="$relativePath/images/logos/maven-feather.png" 
> +               width="90"
> +               height="30"
> +               border="1"
> +               />
>          </a>
>      #end
>  #end
> 
> 
> 


-- 
Dennis Lundberg

Re: svn commit: r595592 - /maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm

Posted by Dennis Lundberg <de...@apache.org>.
Oversized logos could be handled by documenting the recommended size of 
alternate PoweredBy logos. Aligning to width of the log to the width of 
the navigation menu is difficult to do.

We have three options as I see it:

1. Specify a fix size (what's currently in svn) and document this
2. Allow any size the end user wants, documenting the maximum width that 
will fit inside the layout
3. Allow any size the end user wants, documenting the recommended width

The max value in option 2 will be different for different skins. So it 
might be better to use 3 than 2, together with a warning stating 
something like "if your logo is larger it might mess up the layout".

Lukas Theussl wrote:
> Hardcoding is certainly not ideal. Maybe I'm mixing something up here 
> but in m1 I remember the problem that oversized logos messed up the 
> whole page formatting. I haven't checked this here, but if a user has to 
> supply properly sized logos anyway, then it doesn't matter. It should at 
> least be aligned with the width of the navigation menu, is that 
> customizable?
> 
> -Lukas
> 
> 
> Dennis Lundberg wrote:
>> Should we be hardcoding the width and height of the PoweredBy logo? 
>> What if someone wants to use a differently sized logo? It would then 
>> be shrinked or expanded, resulting in a possibly distorted image.
>>
>> ltheussl@apache.org wrote:
>>
>>> Author: ltheussl
>>> Date: Fri Nov 16 00:49:16 2007
>>> New Revision: 595592
>>>
>>> URL: http://svn.apache.org/viewvc?rev=595592&view=rev
>>> Log:
>>> [DOXIASITETOOLS-3] Add titles to hrefs, tweaks to powered by
>>> Submitted by: Tim Pizey
>>>
>>> Modified:
>>>     
>>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>>>
>>>
>>> Modified: 
>>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>>>
>>> URL: 
>>> http://svn.apache.org/viewvc/maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm?rev=595592&r1=595591&r2=595592&view=diff 
>>>
>>> ============================================================================== 
>>>
>>> --- 
>>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>>> (original)
>>> +++ 
>>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>>> Fri Nov 16 00:49:16 2007
>>> @@ -11,9 +11,9 @@
>>>  #macro ( banner $banner $id )
>>>    #if ( $banner )
>>>      #if( $banner.href )
>>> -      <a href="$banner.href" id="$id">
>>> +      <a href="$banner.href" id="$id" #if( $banner.alt ) 
>>> title="$banner.alt" #end >
>>>      #else
>>> -        <span id="$id">
>>> +        <div id="$id">
>>>      #end
>>>  
>>>      #if( $banner.src )
>>> @@ -25,7 +25,7 @@
>>>          #if ( $banner.alt )
>>>              #set ( $alt = $banner.alt )
>>>          #else
>>> -            #set ( $alt = "" )
>>> +            #set ( $alt = $banner.name )
>>>          #end
>>>          <img src="$src" alt="$alt" />
>>>      #else
>>> @@ -35,7 +35,7 @@
>>>      #if( $banner.href )
>>>          </a>
>>>      #else
>>> -        </span>
>>> +        </div>
>>>      #end
>>>    #end
>>>  #end
>>> @@ -76,7 +76,7 @@
>>>      #foreach( $subitem in $item.items )
>>>        #set ( $subitemHref = $PathTool.calculateLink( $subitem.href, 
>>> $relativePath ) )
>>>        #set ( $subitemHref = $subitemHref.replaceAll( "\\", "/" ) )
>>> -
>>> +      #set ( $display = false )
>>>        #if ( $alignedFileName == $subitemHref )
>>>          #set ( $display = true )
>>>        #end
>>> @@ -187,6 +187,9 @@
>>>      #else
>>>        #set ( $versionPosition = "left" )
>>>      #end
>>> +  #else
>>> +    #set ( $version = "" )
>>> +    #set ( $versionPosition = "left" )
>>>    #end
>>>  
>>>    #set ( $breadcrumbs = $decoration.body.breadcrumbs )
>>> @@ -272,17 +275,33 @@
>>>              <a href="$href" title="$name" class="poweredBy">
>>>                #set ( $img = $PathTool.calculateLink( $img, 
>>> $relativePath ) )
>>>                #set ( $img = $img.replaceAll( "\\", "/" ) )
>>> -              <img alt="$name" src="$img" />
>>> +              <img  class="poweredBy"  +                    
>>> alt="$name" +                    src="$img" +                    
>>> width="90"
>>> +                    height="30"
>>> +              />
>>>              </a>
>>>          #end
>>>          #if( $poweredBy.isEmpty() )
>>>            <a href="http://maven.apache.org/" title="$i18n.getString( 
>>> "site-renderer", $locale, "template.builtby" ) Maven" class="poweredBy">
>>> -            <img alt="$i18n.getString( "site-renderer", $locale, 
>>> "template.builtby" ) Maven" 
>>> src="$relativePath/images/logos/maven-feather.png"></img>
>>> +            <img class="poweredBy" +                 
>>> alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) 
>>> Maven" +                 
>>> src="$relativePath/images/logos/maven-feather.png" +                 
>>> width="90"
>>> +                 height="30"
>>> +                 border="1" />
>>>            </a>
>>>          #end
>>>      #else
>>>          <a href="http://maven.apache.org/" title="$i18n.getString( 
>>> "site-renderer", $locale, "template.builtby" ) Maven" class="poweredBy">
>>> -          <img alt="$i18n.getString( "site-renderer", $locale, 
>>> "template.builtby" ) Maven" 
>>> src="$relativePath/images/logos/maven-feather.png"></img>
>>> +          <img class="poweredBy" +               
>>> alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) 
>>> Maven" +               
>>> src="$relativePath/images/logos/maven-feather.png" +               
>>> width="90"
>>> +               height="30"
>>> +               border="1"
>>> +               />
>>>          </a>
>>>      #end
>>>  #end
>>>
>>>
>>>
>>
>>
> 


-- 
Dennis Lundberg

Re: svn commit: r595592 - /maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm

Posted by Lukas Theussl <lt...@apache.org>.
Hardcoding is certainly not ideal. Maybe I'm mixing something up here 
but in m1 I remember the problem that oversized logos messed up the 
whole page formatting. I haven't checked this here, but if a user has to 
supply properly sized logos anyway, then it doesn't matter. It should at 
least be aligned with the width of the navigation menu, is that 
customizable?

-Lukas


Dennis Lundberg wrote:
> Should we be hardcoding the width and height of the PoweredBy logo? What 
> if someone wants to use a differently sized logo? It would then be 
> shrinked or expanded, resulting in a possibly distorted image.
> 
> ltheussl@apache.org wrote:
> 
>> Author: ltheussl
>> Date: Fri Nov 16 00:49:16 2007
>> New Revision: 595592
>>
>> URL: http://svn.apache.org/viewvc?rev=595592&view=rev
>> Log:
>> [DOXIASITETOOLS-3] Add titles to hrefs, tweaks to powered by
>> Submitted by: Tim Pizey
>>
>> Modified:
>>     
>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>>
>>
>> Modified: 
>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>>
>> URL: 
>> http://svn.apache.org/viewvc/maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm?rev=595592&r1=595591&r2=595592&view=diff 
>>
>> ============================================================================== 
>>
>> --- 
>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>> (original)
>> +++ 
>> maven/doxia/doxia-sitetools/trunk/doxia-site-renderer/src/main/resources/org/apache/maven/doxia/siterenderer/resources/default-site.vm 
>> Fri Nov 16 00:49:16 2007
>> @@ -11,9 +11,9 @@
>>  #macro ( banner $banner $id )
>>    #if ( $banner )
>>      #if( $banner.href )
>> -      <a href="$banner.href" id="$id">
>> +      <a href="$banner.href" id="$id" #if( $banner.alt ) 
>> title="$banner.alt" #end >
>>      #else
>> -        <span id="$id">
>> +        <div id="$id">
>>      #end
>>  
>>      #if( $banner.src )
>> @@ -25,7 +25,7 @@
>>          #if ( $banner.alt )
>>              #set ( $alt = $banner.alt )
>>          #else
>> -            #set ( $alt = "" )
>> +            #set ( $alt = $banner.name )
>>          #end
>>          <img src="$src" alt="$alt" />
>>      #else
>> @@ -35,7 +35,7 @@
>>      #if( $banner.href )
>>          </a>
>>      #else
>> -        </span>
>> +        </div>
>>      #end
>>    #end
>>  #end
>> @@ -76,7 +76,7 @@
>>      #foreach( $subitem in $item.items )
>>        #set ( $subitemHref = $PathTool.calculateLink( $subitem.href, 
>> $relativePath ) )
>>        #set ( $subitemHref = $subitemHref.replaceAll( "\\", "/" ) )
>> -
>> +      #set ( $display = false )
>>        #if ( $alignedFileName == $subitemHref )
>>          #set ( $display = true )
>>        #end
>> @@ -187,6 +187,9 @@
>>      #else
>>        #set ( $versionPosition = "left" )
>>      #end
>> +  #else
>> +    #set ( $version = "" )
>> +    #set ( $versionPosition = "left" )
>>    #end
>>  
>>    #set ( $breadcrumbs = $decoration.body.breadcrumbs )
>> @@ -272,17 +275,33 @@
>>              <a href="$href" title="$name" class="poweredBy">
>>                #set ( $img = $PathTool.calculateLink( $img, 
>> $relativePath ) )
>>                #set ( $img = $img.replaceAll( "\\", "/" ) )
>> -              <img alt="$name" src="$img" />
>> +              <img  class="poweredBy"  +                    
>> alt="$name" +                    src="$img" +                    
>> width="90"
>> +                    height="30"
>> +              />
>>              </a>
>>          #end
>>          #if( $poweredBy.isEmpty() )
>>            <a href="http://maven.apache.org/" title="$i18n.getString( 
>> "site-renderer", $locale, "template.builtby" ) Maven" class="poweredBy">
>> -            <img alt="$i18n.getString( "site-renderer", $locale, 
>> "template.builtby" ) Maven" 
>> src="$relativePath/images/logos/maven-feather.png"></img>
>> +            <img class="poweredBy" +                 
>> alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) 
>> Maven" +                 
>> src="$relativePath/images/logos/maven-feather.png" +                 
>> width="90"
>> +                 height="30"
>> +                 border="1" />
>>            </a>
>>          #end
>>      #else
>>          <a href="http://maven.apache.org/" title="$i18n.getString( 
>> "site-renderer", $locale, "template.builtby" ) Maven" class="poweredBy">
>> -          <img alt="$i18n.getString( "site-renderer", $locale, 
>> "template.builtby" ) Maven" 
>> src="$relativePath/images/logos/maven-feather.png"></img>
>> +          <img class="poweredBy" +               
>> alt="$i18n.getString( "site-renderer", $locale, "template.builtby" ) 
>> Maven" +               
>> src="$relativePath/images/logos/maven-feather.png" +               
>> width="90"
>> +               height="30"
>> +               border="1"
>> +               />
>>          </a>
>>      #end
>>  #end
>>
>>
>>
> 
>