From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ricardo Wurmus Newsgroups: gmane.lisp.guile.devel Subject: Re: Contributions to Guile Date: Mon, 08 Feb 2016 20:22:22 +0100 Message-ID: <87oabruhw1.fsf@elephly.net> References: <87twlno63d.fsf@gnu.org> <877figyxb2.fsf@dustycloud.org> <87si13k4nn.fsf@gnu.org> <87vb5zxe0o.fsf@dustycloud.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1454959380 13938 80.91.229.3 (8 Feb 2016 19:23:00 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Feb 2016 19:23:00 +0000 (UTC) Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= , guile-devel@gnu.org To: Christopher Allan Webber Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Feb 08 20:22:47 2016 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aSrOX-0007s3-K1 for guile-devel@m.gmane.org; Mon, 08 Feb 2016 20:22:45 +0100 Original-Received: from localhost ([::1]:48075 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSrOW-00071S-UY for guile-devel@m.gmane.org; Mon, 08 Feb 2016 14:22:44 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55792) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSrOP-00071G-Pa for guile-devel@gnu.org; Mon, 08 Feb 2016 14:22:38 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aSrOO-0001pP-GA for guile-devel@gnu.org; Mon, 08 Feb 2016 14:22:37 -0500 Original-Received: from sender163-mail.zoho.com ([74.201.84.163]:25095) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSrOI-0001og-32; Mon, 08 Feb 2016 14:22:30 -0500 Original-Received: from localhost (xd933e82b.dyn.telefonica.de [217.51.232.43]) by mx.zohomail.com with SMTPS id 1454959346473494.05217686329763; Mon, 8 Feb 2016 11:22:26 -0800 (PST) User-agent: mu4e 0.9.13; emacs 24.5.1 In-reply-to: <87vb5zxe0o.fsf@dustycloud.org> X-Zoho-Virus-Status: 1 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 74.201.84.163 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:18157 Archived-At: Christopher Allan Webber writes: >>> If the html export was nicely themed >> >> It can be nicely themed. FWIW, Gnulib’s gendocs.sh, which is what most >> projects use to export their HTML to gnu.org, now includes a CSS by >> default (see as an example.) We can >> change this CSS anytime, and in fact, I would love it if someone >> talented would come up with improvements! > > Ok, yeah > https://gnu.org/software/guix/manual/html_node/Derivations.html#Derivations > does look a lot nicer! I think it could look nicer still; eg, Racket's > docs using Scribble and anything using Sphinx tends to seem more nicely > themed: > > https://hy.readthedocs.org/en/latest/tutorial.html > https://docs.racket-lang.org/guide/define.html > > I think maybe the left-hand bar kind of helps, and some tweaks to the > coloring might help too. I would like to note that a while ago I prepared a *very simple* style sheet for GNU manuals to make it easier for me to read them online: https://userstyles.org/styles/108215/gnu-manuals This works with the “stylish” extension, which is available here: https://addons.mozilla.org/en-US/firefox/addon/stylish/ I’m not claiming that this is beautiful, but it fixes a couple of things that I found most annoying about the defaults. The most obvious changes are: * limited maximum line width * list bullets in the frame * scaling (the font size changes as the window is resized, but the line width stays the same) * different colour for navigation header I kept the changes to a minimum because I hoped they would be uncontroversial enough to be accepted as an incremental improvement over the defaults. Some of the HTML produced by Texinfo isn’t annotated very well, so it’s hard to find a generic style that works for every manual out there. I think that http://practicaltypography.com is really pretty and with a little more tweaking the online manuals could look similarly attractive. ~~ Ricardo