Date: Thu, 4 Sep 2003 16:05:39 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: Ceri Davies <setantae@submonkey.net> Cc: freebsd-doc@freebsd.org Subject: Re: Tidy options Message-ID: <20030904140539.GB385@FreeBSD.org> In-Reply-To: <20030904123441.GD25063@submonkey.net> References: <20030903230035.GB386@FreeBSD.org> <20030904123441.GD25063@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
--aM3YZ0Iwxop3KEKx Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.09.04 13:34:41 +0100, Ceri Davies wrote: > On Thu, Sep 04, 2003 at 01:00:37AM +0200, Simon L. Nielsen wrote: > > In the DocBook documentation with HTML output when using a package > > reference preceded by a character (with no space in between) there are > > often inserted spaces which looks odd. E.g from > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/video-playbac= k.html > >=20 > > ... codec with MPEG3 audio encoding ( audio/lame is required): > >=20 > > The HTML that gives this problem is: > >=20 > > the MPEG4 codec with MPEG3 audio encoding (<a > > href=3D"http://www.FreeBSD.org/cgi/url.cgi?ports/audio/lame= /pkg-descr"> > > <tt class=3D"FILENAME">audio/lame</tt></a> is > >=20 > > The problem is that Tidy is a bit too agressive when trying to make the > > HTML look nice, so it inserts newline where it really shouldn't, since > > it tries to keep the lines at max 68 characters (the Tidy default > > default). > >=20 > > To fix this I propose to remove the -i flag (which indents the HTML) > > from the default Tidy arguments and add '-wrap 90'. This makes the HTML > > more "ugly", but I don't really think this matters, since it's still > > correct and of course the browsers doesn't care. If anybody for some > > reason still like to generate more readable HTML, they can just use the > > TIDYFLAG make variable to override the defaults. >=20 > Doesn't this simply decrease the chance of this happening, as opposed to > actually fixing the issue? Surely the above situation can still occur on > a 90 column boundary. Yes, I should have mentioned that. The chance that it actually happen is reduced a lot. It would have to be a very long package name for the problem to occur with the proposed settings. > > Any objection to changing this? >=20 > Not really, but it doesn't sound like a real fix, unless I'm misunderstan= ding > something. It is a workaround, and of course tidy should do it right in any case, but this will got us a long way without having to modify tidy. If somebody has the time to fix Tidy it would be great, but I don't at the moment. --=20 Simon L. Nielsen FreeBSD Documentation Team --aM3YZ0Iwxop3KEKx Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/V0azh9pcDSc1mlERAoOOAJ4w7DYQ1jaWM9Tpq7If2cyWrIpd8wCgsitN iREifVNbaGcPpzBx1Eq9Pbc= =1CaJ -----END PGP SIGNATURE----- --aM3YZ0Iwxop3KEKx--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030904140539.GB385>