text appears outside of box on help.ubuntu.com

[Book 'em Dano]

Binary package hint: ubuntu-docs

On https://help.ubuntu.com/10.04/serverguide/C/jeos-and-vmbuilder.html, in the "Partitioning" section and the "Install a Local Mirror" section where code/input/output is exhibited, there are portions of the code/input/output that extend beyond the boundary of the box. For the sake of aesthetics, the code/input/output should wrap inside the box, so that all of it is contained with the box.

ProblemType: Bug
Architecture: i386
CheckboxSubmission: 170355afe57f2ed52964cfd1728cbc14
CheckboxSystem: edda5d4f616ca792bf437989cb597002
Date: Tue Nov 23 02:13:07 2010
DistroRelease: Ubuntu 9.10
InstallationMedia: Ubuntu 9.10 "Karmic Koala" - Release i386 (20091028.5)
Package: ubuntu-docs 9.10.11
PackageArchitecture: all
ProcEnviron:
 LANG=en_US.UTF-8
 SHELL=/bin/bash
ProcVersionSignature: Ubuntu 2.6.31-22.68-generic-pae
SourcePackage: ubuntu-docs
Uname: Linux 2.6.31-22-generic-pae i686

[Robert Roth (evfool)]

Similar to bug #590519. What would be a possible solution for this? how can we wrap a long command line script?

[Connor Imes (ckimes)]

It is possible that wrapping the line will cause the data in the section to become invalid or otherwise improperly formatted which is worse than the current problem. Maybe we can modify the template so that those sections are given horizontal scroll bars if the text does not fit in the allotted space.

[Connor Imes (ckimes)]

The Ubuntu Documentation team has moved the serverguide out of the ubuntu-docs source, it is now under the serverguide project. This bug could also affect commands in ubuntu-docs desktop help as well, so I'll leave it open under that package.

[Doug Smythies (dsmythies)]

I was hoping to tackle some of these type of issues in the serverguide over the next few days. I have done some experimenting so far. I don't see a problem with wrapping commands via adding, or moving the placement of, the command continuation cahracter "\" for commands. I also don't see an problem with just changing line break locations in <programlisting> segments, as for the most part there are line breaks there already, just in the wrong spot. Am I missing something? I am willing to assign this to me and get on with it, within the much bigger scope of the whole document.

[Connor Imes (ckimes)]

The string changes can be made manually for commands, we just don't have an automated way to do it. You're welcome to make the modifications yourself, but there is no guarantee that in the future the default width of html pages won't change. IIRC, the same problem appears when viewing in yelp which is still a problem for ubuntu-docs.

[Doug Smythies (dsmythies)]

For the most part this is fixed in the 12.04 serverguide, but there are currently 3 exceptions for larger excertions beyond the boundary and few more very small ones.

[Jeremy Bícha (jbicha)]

The particular example mentioned is fixed in 11.10 and later.

https://help.ubuntu.com/11.10/serverguide/jeos-and-vmbuilder.html