From nobody@FreeBSD.org  Tue Feb 18 05:27:45 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id B31E55A9
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 18 Feb 2014 05:27:45 +0000 (UTC)
Received: from newred.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id 9D6AE1CD0
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 18 Feb 2014 05:27:45 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by newred.freebsd.org (8.14.7/8.14.7) with ESMTP id s1I5Rj7e023443
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 18 Feb 2014 05:27:45 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.7/8.14.7/Submit) id s1I5RjXK023429;
	Tue, 18 Feb 2014 05:27:45 GMT
	(envelope-from nobody)
Message-Id: <201402180527.s1I5RjXK023429@cgiserv.freebsd.org>
Date: Tue, 18 Feb 2014 05:27:45 GMT
From: Allan Jude <freebsd@allanjude.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: improve handbook ToC readability
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         186857
>Category:       docs
>Synopsis:       improve handbook ToC readability
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    wblock
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 18 05:30:00 UTC 2014
>Closed-Date:    Sat Mar 22 19:17:41 UTC 2014
>Last-Modified:  Sat Mar 22 19:17:41 UTC 2014
>Originator:     Allan Jude
>Release:        9.2-RELEASE
>Organization:
ScaleEngine Inc.
>Environment:
FreeBSD Trooper.HML3.ScaleEngine.net 9.2-RELEASE FreeBSD 9.2-RELEASE #0 r255898: Thu Sep 26 22:50:31 UTC 2013     root@bake.isc.freebsd.org:/usr/obj/usr/src/sys/GENERIC  amd64

>Description:
Improve the readability of the Table of Contents of the FreeBSD Handbook by applying colours to links.

Until now the handbook has had no style on links, resulting in the default bright blue / purple link colours.

Apply style to make the colours a little less jaring and easier to read, also makes the page not look like it is from 1994.


Borrowed the colour codes from http://en.wikipedia.org/wiki/Help:Link_color since these seem to be what people will expect
>How-To-Repeat:

>Fix:
Patch Attached

Patch attached with submission follows:

Index: share/misc/docbook.css
===================================================================
--- share/misc/docbook.css	(revision 43975)
+++ share/misc/docbook.css	(working copy)
@@ -34,6 +34,12 @@
   font-weight: bold;
 }
 
+/* Copied from http://en.wikipedia.org/wiki/Help:Link_color */
+a:link                          { color:#0645AD; text-decoration: underline; }
+a:visited                       { color:#663366; text-decoration: underline; }
+a:hover                         { color:#663366; text-decoration: underline; }
+a:active                        { color:#663366; text-decoration: underline; }
+
 div.blockquote-title {
   font-weight: bold;
   margin-top: 1em;


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->wblock 
Responsible-Changed-By: wblock 
Responsible-Changed-When: Tue Feb 18 20:51:15 UTC 2014 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=186857 

From: Allan Jude <freebsd@allanjude.com>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/186857: improve handbook ToC readability
Date: Wed, 19 Mar 2014 16:58:17 -0400

 This is a multi-part message in MIME format.
 --------------050102070304060905090603
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 updated version of the patch with fixed code-style
 
 -- 
 Allan Jude
 
 --------------050102070304060905090603
 Content-Type: text/plain; charset=windows-1252;
  name="docs.css.linkcolor_v2.patch"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="docs.css.linkcolor_v2.patch"
 
 Index: share/misc/docbook.css
 ===================================================================
 --- share/misc/docbook.css	(revision 44279)
 +++ share/misc/docbook.css	(working copy)
 @@ -34,6 +34,17 @@
    font-weight: bold;
  }
  
 +/* Based on http://en.wikipedia.org/wiki/Help:Link_color */
 +a:link { 
 +	color:#0645AD;
 +	text-decoration: underline;
 +}
 +
 +a:visited, a:hover, a:active {
 +	color:#663366;
 +	text-decoration: underline;
 +}
 +
  div.blockquote-title {
    font-weight: bold;
    margin-top: 1em;
 
 --------------050102070304060905090603--

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/186857: commit references a PR
Date: Sat, 22 Mar 2014 19:06:55 +0000 (UTC)

 Author: wblock
 Date: Sat Mar 22 19:06:49 2014
 New Revision: 44330
 URL: http://svnweb.freebsd.org/changeset/doc/44330
 
 Log:
   Improve Handbook ToC readability.  Adjust link colors based on
   http://en.wikipedia.org/wiki/Help:Link_color.  This makes links less
   garish and less distracting when near plain text.
   
   PR:		docs/186857
   Submitted by:	Allan Jude <freebsd@allanjude.com>
 
 Modified:
   head/share/misc/docbook.css
 
 Modified: head/share/misc/docbook.css
 ==============================================================================
 --- head/share/misc/docbook.css	Fri Mar 21 23:33:03 2014	(r44329)
 +++ head/share/misc/docbook.css	Sat Mar 22 19:06:49 2014	(r44330)
 @@ -34,6 +34,16 @@
    font-weight: bold;
  }
  
 +a:link {
 +	color:#0645AD;
 +	text-decoration: underline;
 +}
 +
 +a:visited, a:hover, a:active {
 +	color:#663366;
 +	text-decoration: underline;
 +}
 +
  div.blockquote-title {
    font-weight: bold;
    margin-top: 1em;
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: wblock 
State-Changed-When: Sat Mar 22 19:17:19 UTC 2014 
State-Changed-Why:  
Committed with minor changes.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=186857 
>Unformatted:
