Bug 485045

Summary: PRE-tag blocks flow off right edge of page on fedoraproject.org/wiki site
Product: [Fedora] Fedora Documentation Reporter: "FeRD" (Frank Dana) <ferdnyc>
Component: docs-requestsAssignee: Fedora Websites Team <web-members>
Status: CLOSED CURRENTRELEASE QA Contact: Karsten Wade <kwade>
Severity: medium Docs Contact:
Priority: low    
Version: develCC: bicycle.nutz, nman64, stickster
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-03-04 14:48:01 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Example fedoraproject.org/wiki page as rendered in Firefox3, demonstrating badly formatted PRE none

Description "FeRD" (Frank Dana) 2009-02-11 10:57:45 UTC
Created attachment 331549 [details]
Example fedoraproject.org/wiki page as rendered in Firefox3, demonstrating badly formatted PRE

Description of problem:

Text enclosed inside of a PRE block is formatting poorly on fedoraproject.org/wiki pages, such that it can flow outside the visible page boundaries when the browser window is narrower than the block's rendered size.


How reproducible:

View any page on the wiki containing the HTML PRE tags, resize browser window narrower than the rendered size of that text block.

See attached screenshot for one such example. (Arrows indicate locations where rendering problem occurs.)

  
Actual results:

Text extends outside the visible boundaries of the formatted page, becoming invisible and inaccessible except by widening the browser. For users on smaller displays / when viewing particularly wide blocks of PRE text, the size necessary to view all page elements becomes greater than the maximum visible width of the browser.


Expected results:

Can a brother score a scroll bar?

Ideally, I'd think, blocks wider than the page formatting would become individually scrollable (horizontally, at a minimum).

The other immediately-obvious workaround would involve widening the page to accomodate all PRE blocks (thus making the browser pane horizontally-scrollable at the page level). This would cause wider PRE blocks to force an uncomfortably wide page rendering, requiring horizontal scrolling in order to read any content. As the readability impact of horizontal scrolling (in many languages) is quite severe, the net result of such a change would be a less readable page.

Horizontal scrolling makes sense only in limited use, to overcome issues such as this PRE breakage. Considering some situations leave the content in question completely invisible, ANY level of readability would be an improvement.


Additional info:

I tested this in only one browser:
Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.0.6) Gecko/2009020410 Fedora/3.0.6-1.fc10 Firefox/3.0.6

Other browsers may result in different formatting, and perhaps even display the same content in such a way that PRE text is never unviewable.

However, considering the penetration of Firefox 3 within Fedora installations themselves, it's especially critical that the wiki display correctly when using that browser.

Comment 1 Karsten Wade 2009-02-11 16:15:48 UTC
Yeah, I think what needs to happen is the <pre> box becomes a sideways scrolling window, which we should be able to handle in the CSS, right?

Comment 2 Craig Thomas 2009-02-11 17:12:42 UTC
I have committed a fix for this :

diff --git a/fedoraproject.org/static/css/fedora.css b/fedoraproject.org/static/css/fedora.css

index df69b7d..4a5cabc 100644 (file)

--- a/fedoraproject.org/static/css/fedora.css
+++ b/fedoraproject.org/static/css/fedora.css

@@ -23,6 +23,7 @@ a img

 pre

 {

   font-size: 2.6ex;

+  overflow: auto;

 }

 

 #wrapper

Comment 3 "FeRD" (Frank Dana) 2009-02-12 05:56:28 UTC
Wow, that was a simple and elegant patch!

After a forced reload of the page, the new rendering looks good -- the wide PRE sections scroll to provide full visibility (and allow extra vertical space for the scrollbar, so there's no vertical scrolling side-effect), and everything else on the page is unaffected.

Thanks for the quick attention!

Comment 4 "FeRD" (Frank Dana) 2009-03-03 08:23:25 UTC
..Noticed this bug in my reporting list. I don't know the usual steps, but as the problem was fixed overnight and has remained fixed for over 3 weeks, presumably this can be closed?

As reporter it seems I'm able to do that... but I'm not sure I "should".

Comment 5 Karsten Wade 2009-03-04 14:48:01 UTC
Closed, thanks.

Comment 6 Karsten Wade 2009-03-04 15:57:25 UTC
Sorry, one last comment I forgot to make.  It is perfectly fine for a reporter to close a bug after confirming that it is indeed fixed or the solution is otherwise acceptable.  Thanks again for following through with filing this bug. :)

Comment 7 eric 2009-08-05 18:43:30 UTC
Tickets move to docs-request so the fedora-websites component can be removed per request from Ricky.