[lnkForumImage]
TotalShareware - Download Free Software
Confronta i prezzi di migliaia di prodotti.
Asp Forum
 Home | Login | Register | Search 


 

Forums >

comp.lang.ruby

Michael Granger's RDoc template

Gavin Sinclair

11/17/2003 11:54:00 AM

Hi -talk,

Has anyone attempted to improve on Mike's excellent effort yet? The
Wiki page is bare.

I just wanted to mention that it's rather odd that <h1> is rendered
larger than <h2>. It's not just my browser, surely.

Other points of style I disagree with:
- light blue background for text in Files/Classes/Methods frames when
surrounding background is white
- rendering of dictionary lists could be improved with a little
vertical space between entries
- hyperlinks: blue background on mouse over doesn't grab me; I'd
rather see classic underlines

Anyway, it's a great piece of work, and hasn't seen a mention on the
list in a while, so ...

Cheers,
Gavin
9 Answers

Peter Hickman

11/17/2003 12:24:00 PM

0

Gavin Sinclair wrote:
> I just wanted to mention that it's rather odd that <h1> is rendered
> larger than <h2>. It's not just my browser, surely.

Sorry you lost me here. H1 is the largest H5 (or is it H6) the smallest, thats
the way HTML works. What are you expecting?

Gavin Sinclair

11/17/2003 1:22:00 PM

0

On Monday, November 17, 2003, 11:24:25 PM, Peter wrote:

> Gavin Sinclair wrote:
>> I just wanted to mention that it's rather odd that <h1> is rendered
>> larger than <h2>. It's not just my browser, surely.

> Sorry you lost me here. H1 is the largest H5 (or is it H6) the smallest, thats
> the way HTML works. What are you expecting?

My mistake: I meant to say that H1 renders *smaller* than H2.

Gavin

Josef 'Jupp' Schugt

11/17/2003 9:46:00 PM

0

Hi!

* Gavin Sinclair; 2003-11-17, 14:37 UTC:
> My mistake: I meant to say that H1 renders *smaller* than H2.

H1 and H2 are logical markup tags. It is up to the browsers if and
how they use physical markup to display them.

Several browsers (Mosaic, Opera, ...) allow you to fine-tune the look
of every level. Perhaps you did misconfigure the one you use?

Josef 'Jupp' Schugt
--
.-------.
message > 100 kB? / | |
sender = spammer? / | R.I.P.|
text = spam? / ___| |___

Nikolai Weibull

11/17/2003 10:30:00 PM

0

* Josef 'Jupp' SCHUGT <jupp@gmx.de> [Nov, 17 2003 22:50]:
> H1 and H2 are logical markup tags. It is up to the browsers if and
> how they use physical markup to display them.
eh?
> Several browsers (Mosaic, Opera, ...) allow you to fine-tune the look
> of every level. Perhaps you did misconfigure the one you use?
no he probably didn't, the style sheet is messed up - for the reason
that .big-title-font sets its font-size to large, while
small-title-font sets it to 10px.
nikolai

--
::: name: Nikolai Weibull :: aliases: pcp / lone-star / aka :::
::: born: Chicago, IL USA :: loc atm: Gothenburg, Sweden :::
::: page: www.pcppopper.org :: fun atm: gf,lps,ruby,lisp,war3 :::
main(){printf(&linux["\021%six\012\0"],(linux)["have"]+"fun"-97);}

Josef 'Jupp' Schugt

11/18/2003 1:57:00 PM

0

Hi!

* Nikolai Weibull; 2003-11-17, 23:51 UTC:
> * Josef 'Jupp' SCHUGT <jupp@gmx.de> [Nov, 17 2003 22:50]:
> > H1 and H2 are logical markup tags. It is up to the browsers if and
> > how they use physical markup to display them.
> eh?

Didn't notice that 'template' is used in place of 'stylesheet'. To me
a 'template' would be something like this:

<html>
<head>
<title>#{title}</title>
<body>
<h1>#{title}<h1>
<h2>#{date}</h2>
#{ads}
#{news}
#{disclaimer}
</body>
</html>

Perhaps calling a stylesheet a stylesheet is a good idea (TM)?

Josef 'Jupp' Schugt
--
.-------.
message > 100 kB? / | |
sender = spammer? / | R.I.P.|
text = spam? / ___| |___

Nikolai Weibull

11/18/2003 2:14:00 PM

0

* Josef 'Jupp' SCHUGT <jupp@gmx.de> [Nov, 18 2003 15:00]:
> Didn't notice that 'template' is used in place of 'stylesheet'. To me
> a 'template' would be something like this:
[an HTML template]
> Perhaps calling a stylesheet a stylesheet is a good idea (TM)?
eh?
it's a template, and the template uses a stylesheet. the thing is that
no h1's or h2's are being used, rather tables and classes are used to
set text properties - which is of course bad, but that's the way the
template works at the moment...
nikolai

--
::: name: Nikolai Weibull :: aliases: pcp / lone-star / aka :::
::: born: Chicago, IL USA :: loc atm: Gothenburg, Sweden :::
::: page: www.pcppopper.org :: fun atm: gf,lps,ruby,lisp,war3 :::
main(){printf(&linux["\021%six\012\0"],(linux)["have"]+"fun"-97);}

Michael Granger

11/18/2003 5:23:00 PM

0

On Nov 18, 2003, at 7:13 AM, Nikolai Weibull wrote:

> it's a template, and the template uses a stylesheet. the thing is that
> no h1's or h2's are being used, rather tables and classes are used to
> set text properties - which is of course bad, but that's the way the
> template works at the moment...

I think you're confused. The template I created *does* use h1 and h2
(IMO correctly), and only uses tables for tabular data, preferring
<div> for most things. The stylesheet doesn't (as suggested in a
previous post) even have .{big,small}-title-font classes, nor do the h1
or h2 elements set the font size to 'large' or pixel-sizes. The h1
element is set to "120%" in the default stylesheet, but I try to avoid
absolute pixel-sizes whenever possible when targeting many browsers.

Responding to the general thread:

I have no idea why an element whose font-size is set to "120%" would
render smaller than a default h2. I've tested it in Mozilla, IE, and
Safari on MacOSX, and Mozilla and Konqueror in Linux. Suggestions about
how to eliminate this problem welcomed.

The aesthetics of it are of course subject to debate, but that's the
nature of aesthetics. I dislike the classic underline, especially in a
page that's so link-heavy, but there's certainly a case to be made for
making links look like people expect them to look.

Soon after I submitted the 'css2' template, I also submitted (and Dave
accepted) a patch that allows you to set your own custom stylesheet,
which I think is a better solution than debating the aesthetic merits
of the default stylesheet anyway. This allows you to use the css2 (or
any other)
template, but provide a stylesheet which reflects your own particular
tastes.

--
Michael Granger <ged@FaerieMUD.org>
Rubymage, Believer, Architect
The FaerieMUD Consortium <http://www.FaerieMU...

Nikolai Weibull

11/18/2003 7:36:00 PM

0

* Michael Granger <ged@FaerieMUD.org> [Nov, 18 2003 19:30]:
> I think you're confused.
I must be. I was talking about the -T kilmer theme.
so, where can i get your theme?
nikolai

--
::: name: Nikolai Weibull :: aliases: pcp / lone-star / aka :::
::: born: Chicago, IL USA :: loc atm: Gothenburg, Sweden :::
::: page: www.pcppopper.org :: fun atm: gf,lps,ruby,lisp,war3 :::
main(){printf(&linux["\021%six\012\0"],(linux)["have"]+"fun"-97);}

Michael Granger

11/18/2003 10:57:00 PM

0


On Nov 18, 2003, at 12:36 PM, Nikolai Weibull wrote:
> so, where can i get your theme?

It's the 'css2' theme in the CVS version.

--
Michael Granger <ged@FaerieMUD.org>
Rubymage, Believer, Architect
The FaerieMUD Consortium <http://www.FaerieMU...