1 |
On 2010-09-30, Dale <rdalek1967@×××××.com> wrote: |
2 |
> Grant Edwards wrote: |
3 |
> |
4 |
>>>> http://www.gentoo.org/proj/en/base/embedded/handbook/?part=1&chap=2 |
5 |
>>>> |
6 |
>>>> |
7 |
>>> This one has a horizontal scrollbar but only adjust about a half inch or |
8 |
>>> so. It almost fits. |
9 |
>>> |
10 |
>> Are the text paragraphs re-wrapped as you narrow the window? |
11 |
> |
12 |
> That one has a scrollbar no matter what. It appears that section "Code |
13 |
> Listing 2.4: Using SH4 cross-compiler" is making it really long. It has |
14 |
> a line in that box that is pretty long. It's the longest line I saw in |
15 |
> the whole page. |
16 |
> |
17 |
> So, it appears as someone else posted that the pretty blue boxes set |
18 |
> the minimum width. |
19 |
|
20 |
I think that's definitely the issue. |
21 |
|
22 |
> Whatever is the longest line sets the width. How would one go about |
23 |
> changing that I wonder? |
24 |
|
25 |
I think it can probably be set in the CSS stylesheet, but I'm pretty |
26 |
fuzzy when it comes to CSS details. |
27 |
|
28 |
I do know that the web pages I generate with asciidoc don't have this |
29 |
problem. In general, the width of the text paragraphs is determined |
30 |
by the browser width, but listing blocks don't get wrapped and you may |
31 |
have to scroll over to see the ends of the really wide ones. I |
32 |
usually set a max text width as well, so that if you do widen your |
33 |
browser window to see the really wide listing blocks, you still end up |
34 |
with text columns that max out at a reasonable width. Setting a |
35 |
max-width for text is probably more a matter of taste/style, but I |
36 |
don't think that anybody can argue that having the minium text width |
37 |
determined by the maximum listing width is right. |
38 |
|
39 |
> I know when someone posts a long command on this mailing list, it |
40 |
> makes it hard to understand when Seamonkey shops it up into two |
41 |
> lines. |
42 |
|
43 |
We definitely don't want to wrap things like command lines, config |
44 |
file listings, code listings, and program input/output. That's why |
45 |
you (directly or indirectly) assign them a different CSS style or |
46 |
object type -- so that you can do things like wrap normal text and not |
47 |
listings or examples. |
48 |
|
49 |
> Most people are good enough to post that the command has to be all on |
50 |
> one line tho. It appears that a email problem is also a website |
51 |
> problem too. When to wrap a line and when not to? |
52 |
|
53 |
I don't think listings/code/shell-examples should not be wrapped, and |
54 |
AFAIK, nobody's arguing that they should be. |
55 |
|
56 |
However, I do assert that normal text paragraphs should be wrapped to |
57 |
fit within the browser window. |
58 |
|
59 |
In text-only e-mail messages, there's no way to tell the difference |
60 |
between the two. |
61 |
|
62 |
Whatever's generating the HTML/CSS for the Gentoo manual web pages |
63 |
does know the difference, and should be able to do The Right |
64 |
Thing(tm). The manual HTML is definitely machine-generated, but I |
65 |
can't tell you by what at this point, so I can't offer a specific |
66 |
fix... |
67 |
|
68 |
-- |
69 |
Grant Edwards grant.b.edwards Yow! Can you MAIL a BEAN |
70 |
at CAKE? |
71 |
gmail.com |