From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 21:48:02 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A3FEC1065670; Mon, 20 Aug 2012 21:48:02 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 4EEE98FC0C; Mon, 20 Aug 2012 21:48:02 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id A7FBB14E7F65; Mon, 20 Aug 2012 23:48:00 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id C17tV1hLyk0i; Mon, 20 Aug 2012 23:47:56 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id A127614E7F61; Mon, 20 Aug 2012 23:47:56 +0200 (CEST) Message-ID: <5032B08B.8060706@FreeBSD.org> Date: Mon, 20 Aug 2012 23:47:55 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: Doug Barton References: <50326A70.5020009@FreeBSD.org> <5032AB02.2040608@FreeBSD.org> In-Reply-To: <5032AB02.2040608@FreeBSD.org> X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 21:48:02 -0000 Em 20-08-2012 23:24, Doug Barton escreveu: > 1. On http://people.freebsd.org/~gabor/xmlweb/data/ the vertical > separators on the location bar extend down below the grey > background. Not sure if this is a byproduct of my default font > setting being larger than normal or not. I think so because I tried in two different browsers (Firefox and Opera) and it seems normal to me. But if I click on the Large text option, it renders badly. But interestingly, if I only keep pressing Ctrl-+ it never goes wrong. I think that nowadays it is possible in any modern browser to adjust text size, so maybe we should rely on that feature and remove the text size setting and the associated JavaScript code. This is something I thought of earlier but haven't yet raised it on the lists. I'll raise it up when going for the next step of refactoring. > 2. Comparing > http://people.freebsd.org/~gabor/xmlweb/data/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html > > vs. > http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html > > it seems that many elements are missing. The backgrounds for the code > and notes, and the colored text for literals are what stand out > most to me. > > 3. On > http://people.freebsd.org/~gabor/xmlweb/data/doc/en_US.ISO8859-1/books/porters-handbook/security-notify.html > > vs. > http://www.freebsd.org/doc/en/books/porters-handbook/security-notify.html > I see those same problems. I also noticed that the red square for > the Important: section is gone, and that the text following the > callouts starts on a new line, instead of following the callout > image directly. These both come from the fact that class names are now all in lower case. I don't know the exact reason since I only converted them to lower case in htdocs/ since these are generated with DSSSL. What I suspect is that whether they are generated upper or lower case has to do with tidy. It did such things like converting elements to upper case or messing up character sets, that's why I disabled it in the Hungarian translation from the beginning and now for the whole web. It is also planned to disable it entirely for all docs but the output that Jade generates isn't that fancy. I'll track this down. > I hope that this feedback is useful. Of course, it was very useful! I noticed that everything was readable but I didn't remember to visually compare the results. Thanks for the review! Gabor