You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-dev@xmlgraphics.apache.org by The Web Maestro <th...@gmail.com> on 2007/08/02 08:25:09 UTC
Re: Help Refactoring the Website
On 7/31/07, Vincent Hennebert <vi...@anyware-tech.com> wrote:
> Hi Clay,
>
> Thanks for chiming in!
I've committed my changes, so the site should be re-factored. There is
likely a bunch of content in the '0.94' realm that needs updating so
it's more relevant to the current release. In addition, there may be
some pages, which will need some attention (like
'branches/fop-0_94/build/site/0.94/releaseNotes_0.94.html',
'branches/fop-0_94/build/site/0.94/changes_0.94.html' and
'branches/fop-0_94/build/site/0.94/knownissues_overview.html').
> > It didn't take too much to re-factor the site... Just had to adjust
> > the tabs.xml and site.xml documents (and remove the 0.20.5 documents).
> > I'll need to do a `svn delete` for the 0.20.5/ and 0.93/ directories,
> > so let me know if I should do that NOW, or we need to wait until we're
> > more ready for the release.
>
> As I said I already did it, but if you wanna double-check all the
> better. Also, one thing that would be great if you could have a look at,
> is improving the stylesheet a bit. For example the main content is set
> to be displayed at 80% of its size. That should really not be the case
> as the setting for the main text's size should be left to the user's
> choice (I'm ok with reducing the size of e.g. the menu, however). I'm
> not really sure where to change that as the CSS stylesheets seem to
> directly come from the Forrest distribution.
I haven't had a chance to work on the font-size yet, but here're a
couple of links to get started on it if I can't get to it in time:
http://forrest.apache.org/docs_0_70/your-project.html#skins
http://forrest.apache.org/docs_0_70/skin-package.html
FWIW, I tried modifying the
'branches/fop-0_94/src/documentation/skinconf.xml' file, but it didn't
work. I added the 'p, td, li' declaration to adjust it and make it
larger. I didn't commit my change.
Here are a few locations for the Forrest skin files if you want to
modify them (although the CSS change may be overwritten if someone
else changes it (hence it'd be better to find a 'skinconf.xml'
solution):
apache-forrest-0.7/main/webapp/skins/pelt/css/profile.css.xslt
fop/trunk/build/site/skin/profile.css
fop/trunk/build/site/skin/profile.css.xslt
However, I think it's somewhat of a 'moot' point, as in the upper
right of the page, there are increase and decrease font-size widget
buttons, and the settings appear to follow you from page to page...
Here's the snippet,
<!--
extra-css - here you can define custom css-elements that are
a. overriding the fallback elements or
b. adding the css definition from new elements that you may have
used in your documentation.
-->
<extra-css>
<!--Example of b.
To define the css definition of a new element that you may have used
in the class attribute of a <p> node.
e.g. <p class="quote"/>
-->
p, td, li {
font-size: 94%;
}
p.quote {
margin-left: 2em;
padding: .5em;
background-color: #f0f0f0;
font-family: monospace;
}
.yes { background-color: #99FF99; }
.no { background-color: #FF9999; }
.partial { background-color: #FFFFCC; }
.ForrestTable td.basic { text-align: center; }
.ForrestTable td.extended { text-align: center; }
.ForrestTable td.complete { text-align: center; }
.ForrestTable td.na { text-align: center; }
.ForrestTable td.yes { background-color: #99FF99;
text-align: center; }
.ForrestTable td.no { background-color: #FF9999;
text-align: center; }
.ForrestTable td.partial { background-color: #FFFFCC;
text-align: center; }
.ForrestTable td.category { /*background-color: #CFDCED;*/
font-size: 1.2em }
</extra-css>
Web Maestro Clay
--
Regards,
The Web Maestro
--
<th...@gmail.com> - <http://homepage.mac.com/webmaestro/>
My religion is simple. My religion is kindness.
- HH The 14th Dalai Lama of Tibet
Re: Help Refactoring the Website
Posted by The Web Maestro <th...@gmail.com>.
BTW, I added a table column for 0.94 to the Compliance page. I did
*not* remove the 0.20.5 or 0.93 columns. Those can be removed fairly
easily, if decided, but I figured we might want to keep those (but add
a note that fop-0.20.5 is unsupported).
Web Maestro Clay
--
Regards,
The Web Maestro
--
<th...@gmail.com> - <http://homepage.mac.com/webmaestro/>
My religion is simple. My religion is kindness.
- HH The 14th Dalai Lama of Tibet
Re: Help Refactoring the Website
Posted by The Web Maestro <th...@gmail.com>.
On 8/2/07, Vincent Hennebert <vi...@anyware-tech.com> wrote:
> >> Strangely enough when I run Forrest on my local copy I get different
> >> (smaller) font sizes than on the website for all the other elements but
> >> the main text (without the above change). The screen.css style sheets
> >> are exactly the same though. I wonder what might be happening?
> >
> > Can you upload the `forrest` output to your web space, so we can take
> > a look? Here's the result of mine from last night (without the
> > #content changes):
> >
> > http://people.apache.org/~clay/fop-0.94/
>
> Here it is:
> http://people.apache.org/~vhennebert/fop-0.94/
The content appears to be *exactly* the same size, but the font-size
for the tabs appears to be smaller in our versions.
> <snip/>
> > I wonder if it has to do with your browser setup (what are you
> > using--browser/version, OS/version w service packs, build etc.)? Have
> > you tried on another machine? Maybe Forrest needs to have a support
> > ticket put in about the font resize buttons (and if you prefer the
> > font-size as well).
>
> Firefox 2.0.0.5
> Ubuntu Feisty
> Revision 556027 of Forrest 0.7 but no CSS file got modified when
> I updated my copy (only Java code).
>
> I think I'm becoming crazy. On your version the main text is smaller
> than on mine (without applying the CSS change), which now has normal
> size. For all other text objects (menu, etc.), sizes are the same.
If I were feeling 'feisty' I might say something pithy, like 'You
probably are going crazy...' but I'm not so I'll tell you that the
reason our sites didn't have the font-size adjust buttons was because
they weren't enabled in 'src/documentation/skinconf.xml'. I just
enabled it, as well as:
- compliance links (shows HTML & CSS compliance badges)
- external-link-image (indicates off-site links with mini-image icon)
- and XML file availability (enables re-purposing of content via XML)
> Trying with Konqueror the main text is larger on my version, but also
> the tab titles (Home, Version 0.93, etc.).
>
> I have no font-size button on any version, with any browser. Note that
> I have them on the XML Graphics site.
Mentioning that it was on the XML Graphics site gave me the clue it
was a preference setting.
> !?!??
> Thanks for looking into this,
> Vincent
Glad I could help... It's been a while since I've delved into Forrest.
In fact, they just released Forrest 0.8, so someone may want to look
into identifying if there's a compelling reason to 'upgrade'. ;-)
--
Regards,
The Web Maestro
--
<th...@gmail.com> - <http://homepage.mac.com/webmaestro/>
My religion is simple. My religion is kindness.
- HH The 14th Dalai Lama of Tibet
Re: Help Refactoring the Website
Posted by Vincent Hennebert <vi...@anyware-tech.com>.
Hi Clay,
The Web Maestro a écrit :
> Hi Vincent,
>
> On 8/2/07, Vincent Hennebert wrote:
<snip/>
>> Thanks for the pointers. By adding the following in skinconf.xml:
>> #content { font-size: 100% }
>> I managed to get normal size for the main text. I didn't commit the
>> change because I wasn't sure this was the right place to do that.
>
> That's perfect. Go ahead and commit...
Ok, I’ll do.
>> Strangely enough when I run Forrest on my local copy I get different
>> (smaller) font sizes than on the website for all the other elements but
>> the main text (without the above change). The screen.css style sheets
>> are exactly the same though. I wonder what might be happening?
>
> Can you upload the `forrest` output to your web space, so we can take
> a look? Here's the result of mine from last night (without the
> #content changes):
>
> http://people.apache.org/~clay/fop-0.94/
Here it is:
http://people.apache.org/~vhennebert/fop-0.94/
<snip/>
> I wonder if it has to do with your browser setup (what are you
> using--browser/version, OS/version w service packs, build etc.)? Have
> you tried on another machine? Maybe Forrest needs to have a support
> ticket put in about the font resize buttons (and if you prefer the
> font-size as well).
Firefox 2.0.0.5
Ubuntu Feisty
Revision 556027 of Forrest 0.7 but no CSS file got modified when
I updated my copy (only Java code).
I think I’m becoming crazy. On your version the main text is smaller
than on mine (without applying the CSS change), which now has normal
size. For all other text objects (menu, etc.), sizes are the same.
Trying with Konqueror the main text is larger on my version, but also
the tab titles (Home, Version 0.93, etc.).
I have no font-size button on any version, with any browser. Note that
I have them on the XML Graphics site.
!?!??
Thanks for looking into this,
Vincent
Re: Help Refactoring the Website
Posted by The Web Maestro <th...@gmail.com>.
Hi Vincent,
On 8/2/07, Vincent Hennebert <vi...@anyware-tech.com> wrote:
> The Web Maestro a écrit :
> > On 7/31/07, Vincent Hennebert wrote:
> >> As I said I already did it, but if you wanna double-check all the
> >> better. Also, one thing that would be great if you could have a look at,
> >> is improving the stylesheet a bit. For example the main content is set
> >> to be displayed at 80% of its size. That should really not be the case
> >> as the setting for the main text's size should be left to the user's
> >> choice (I'm ok with reducing the size of e.g. the menu, however). I'm
> >> not really sure where to change that as the CSS stylesheets seem to
> >> directly come from the Forrest distribution.
> >
> > I haven't had a chance to work on the font-size yet, but here're a
> > couple of links to get started on it if I can't get to it in time:
> >
> > http://forrest.apache.org/docs_0_70/your-project.html#skins
> >
> > http://forrest.apache.org/docs_0_70/skin-package.html
> >
> > FWIW, I tried modifying the
> > 'branches/fop-0_94/src/documentation/skinconf.xml' file, but it didn't
> > work. I added the 'p, td, li' declaration to adjust it and make it
> > larger. I didn't commit my change.
>
> Thanks for the pointers. By adding the following in skinconf.xml:
> #content { font-size: 100% }
> I managed to get normal size for the main text. I didn't commit the
> change because I wasn't sure this was the right place to do that.
That's perfect. Go ahead and commit...
> Strangely enough when I run Forrest on my local copy I get different
> (smaller) font sizes than on the website for all the other elements but
> the main text (without the above change). The screen.css style sheets
> are exactly the same though. I wonder what might be happening?
Can you upload the `forrest` output to your web space, so we can take
a look? Here's the result of mine from last night (without the
#content changes):
http://people.apache.org/~clay/fop-0.94/
> > Here are a few locations for the Forrest skin files if you want to
> > modify them (although the CSS change may be overwritten if someone
> > else changes it (hence it'd be better to find a 'skinconf.xml'
> > solution):
> >
> > apache-forrest-0.7/main/webapp/skins/pelt/css/profile.css.xslt
> > fop/trunk/build/site/skin/profile.css
> > fop/trunk/build/site/skin/profile.css.xslt
> >
> > However, I think it's somewhat of a 'moot' point, as in the upper
> > right of the page, there are increase and decrease font-size widget
> > buttons, and the settings appear to follow you from page to page...
>
> Still, the user shouldn't have to do anything to retrieve their favorite
> text size. That's a basic accessibility rule IMHO.
> Moreover, I don't get any font-size widget button, again both on my
> local copy and the website!? FWIW I'm using the Trunk of the 0.7 branch.
I wonder if it has to do with your browser setup (what are you
using--browser/version, OS/version w service packs, build etc.)? Have
you tried on another machine? Maybe Forrest needs to have a support
ticket put in about the font resize buttons (and if you prefer the
font-size as well).
> <snip/>
>
> Vincent
--
Regards,
The Web Maestro
--
<th...@gmail.com> - <http://homepage.mac.com/webmaestro/>
My religion is simple. My religion is kindness.
- HH The 14th Dalai Lama of Tibet
Re: Help Refactoring the Website
Posted by Vincent Hennebert <vi...@anyware-tech.com>.
Hi Clay,
The Web Maestro a écrit :
> On 7/31/07, Vincent Hennebert wrote:
>
> I've committed my changes, so the site should be re-factored. There is
> likely a bunch of content in the '0.94' realm that needs updating so
> it's more relevant to the current release. In addition, there may be
> some pages, which will need some attention (like
> 'branches/fop-0_94/build/site/0.94/releaseNotes_0.94.html',
> 'branches/fop-0_94/build/site/0.94/changes_0.94.html' and
> 'branches/fop-0_94/build/site/0.94/knownissues_overview.html').
That sounds great, thanks! I’ll have a closer look on the WE and
complete if necessary.
>> As I said I already did it, but if you wanna double-check all the
>> better. Also, one thing that would be great if you could have a look at,
>> is improving the stylesheet a bit. For example the main content is set
>> to be displayed at 80% of its size. That should really not be the case
>> as the setting for the main text's size should be left to the user's
>> choice (I'm ok with reducing the size of e.g. the menu, however). I'm
>> not really sure where to change that as the CSS stylesheets seem to
>> directly come from the Forrest distribution.
>
> I haven't had a chance to work on the font-size yet, but here're a
> couple of links to get started on it if I can't get to it in time:
>
> http://forrest.apache.org/docs_0_70/your-project.html#skins
>
> http://forrest.apache.org/docs_0_70/skin-package.html
>
> FWIW, I tried modifying the
> 'branches/fop-0_94/src/documentation/skinconf.xml' file, but it didn't
> work. I added the 'p, td, li' declaration to adjust it and make it
> larger. I didn't commit my change.
Thanks for the pointers. By adding the following in skinconf.xml:
#content { font-size: 100% }
I managed to get normal size for the main text. I didn’t commit the
change because I wasn’t sure this was the right place to do that.
Strangely enough when I run Forrest on my local copy I get different
(smaller) font sizes than on the website for all the other elements but
the main text (without the above change). The screen.css style sheets
are exactly the same though. I wonder what might be happening?
> Here are a few locations for the Forrest skin files if you want to
> modify them (although the CSS change may be overwritten if someone
> else changes it (hence it'd be better to find a 'skinconf.xml'
> solution):
>
> apache-forrest-0.7/main/webapp/skins/pelt/css/profile.css.xslt
> fop/trunk/build/site/skin/profile.css
> fop/trunk/build/site/skin/profile.css.xslt
>
> However, I think it's somewhat of a 'moot' point, as in the upper
> right of the page, there are increase and decrease font-size widget
> buttons, and the settings appear to follow you from page to page...
Still, the user shouldn’t have to do anything to retrieve their favorite
text size. That’s a basic accessibility rule IMHO.
Moreover, I don’t get any font-size widget button, again both on my
local copy and the website!? FWIW I’m using the Trunk of the 0.7 branch.
<snip/>
Vincent