reassign 507475 asciidoc 8.5.1-1 retitle 507475 asciidoc: HTML output for [verse] requires CSS thanks
Hi Fredrik, Man pages using [verse] markup render as <div class="verseblock"> <div class="verseblock-content"><em>util</em> args... line 2 line 3</div> <div class="verseblock-attribution"> </div></div> which looks great in CSS user agents, but fails in older browsers. As jidanni writes: > Boy you fellows really blew it with e.g., git-cat-file.html and lots > of its brethren. > > > Looks fine in firefox, what's your problem? > > My problem is you are totally relying on CSS. In other browsers or > devices this comes out as one line: > > $ w3m -cols 111 -dump /usr/share/doc/git-doc/git-cat-file.html|fgrep [-t > git-cat-file [-t | -s | -e | -p | <type>] <object> git-cat-file [--batch | > --batch-check] < <list-of-objects> [...] > Anyway, don't depend on CSS, as you then don't pass basic > accessibility guidelines. Jeff King wrote: > On Fri, Dec 12, 2008 at 04:29:14AM +0800, jida...@jidanni.org wrote: >> E.g., pages look like >> >> SYNOPSIS >> >> git-config [<file-option>] [type] [-z|--null] name [value [value_regex]] >> git-config [<file-option>] [type] --add name value git-config >> [<file-option>] [type] --replace-all name [value [value_regex]] git-config >> [<file-option>] [type] [-z|--null] --get name [value_regex] git-config >> [<file-option>] [type] [-z|--null] --get-all name [value_regex] git-config... > > I think this is another asciidoc issue, as git merely specifies "verse" > format for this section. Probably the most friendly thing to do would be > to use > > <pre class="verseblock-content"> > > instead of > > <div class="verseblock-content"> > > so that non-CSS browsers fall back to preserving the line boundaries > (which is what is making it look so unbearable in your text browser). I can reproduce this with the following, built with 'asciidoc -b xhtml11 -d manpage git-cat-file.txt'. What do you think? Thanks, Jonathan -- %< -- git-cat-file(1) =============== NAME ---- git-cat-file - Provide content or type and size information for repository objects SYNOPSIS -------- [verse] 'git cat-file' (-t | -s | -e | -p | <type>) <object> 'git cat-file' (--batch | --batch-check) < <list-of-objects> Author ------ Written by Linus Torvalds <torva...@osdl.org> Documentation -------------- Documentation by David Greaves, Junio C Hamano and the git-list <g...@vger.kernel.org>. -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org