Michael Granger's RDoc template

Gavin Sinclair · Nov 17, 2003

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

Peter Hickman · Nov 17, 2003

Gavin said:
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 · Nov 17, 2003

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 · Nov 17, 2003

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

Nikolai Weibull · Nov 17, 2003

* Josef 'Jupp' SCHUGT said:
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

Josef 'Jupp' SCHUGT · Nov 18, 2003

Hi!

* Nikolai Weibull; 2003-11-17, 23:51 UTC:

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

Nikolai Weibull · Nov 18, 2003

* Josef 'Jupp' SCHUGT said:
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

Michael Granger · Nov 18, 2003

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.

Nikolai Weibull · Nov 18, 2003

* Michael Granger said:
I think you're confused.

I must be. I was talking about the -T kilmer theme.
so, where can i get your theme?
nikolai

Michael Granger · Nov 18, 2003

so, where can i get your theme?

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

[ANN] Rails 0.7.0, Action Pack 0.8.5, Active Record 0.9.5	0	Sep 5, 2004
What is causing the overlap?	1	Jun 12, 2005
PATCH: Speed up direct string concatenation by 20+%!	34	Sep 29, 2006
comp.lang.c Answers to Frequently Asked Questions (FAQ List)	15	Apr 1, 2006
comp.lang.c Answers to Frequently Asked Questions (FAQ List)	1	Feb 1, 2004

Michael Granger's RDoc template

Gavin Sinclair

Peter Hickman

Gavin Sinclair

Josef 'Jupp' SCHUGT

Nikolai Weibull

Josef 'Jupp' SCHUGT

Nikolai Weibull

Michael Granger

Nikolai Weibull

Michael Granger

Ask a Question

Similar Threads

Members online

Forum statistics

Latest Threads